SuperAPI AI 工具集

gh-aw-mcp-gateway

智能体与模型

查看项目

更新于 10-15 22:11

技能介绍

用途:gh-aw-mcp-gateway 是 GitHub Agentic Workflows 中 MCP Gateway 的专业技能,用于配置、部署和运维这一基础设施组件。MCP Gateway 是一个代理服务器,把 AI 智能体的 Model Context Protocol(MCP)请求路由到后端 MCP 服务器,提供集中配置、Docker 容器管理和统一 HTTP API 访问。

主要能力:安全路由(带认证与校验)、Docker 集成(以隔离容器启动后端 MCP 服务器)、协议转换(stdio 与 HTTP 传输)、多服务器路由(GitHub、Serena、自定义)、可观测性(统一日志与按服务器日志)、容器化运行于 GitHub Actions。支持 TOML 文件与 JSON stdin 两种配置模式,具备规范校验、${VAR_NAME} 变量展开、类型与 schema 归一化。路由模式分 routed(/mcp/{serverID})与 unified(/mcp)。

使用方式:可通过 Docker 运行,例如 docker pull ghcr.io/github/gh-aw-mcpg:latest,并挂载 /var/run/docker.sock 与日志目录,设置 MCP_GATEWAY_PORT、MCP_GATEWAY_DOMAIN、MCP_GATEWAY_API_KEY。命令行工具 awmg 支持 --config、--config-stdin、--listen、--log-dir、--routed、--unified、--validate-env 等标志。JSON 配置中 stdio 服务器须指定 container,http 服务器须指定 url;TOML 使用 command 与 args。

适用场景:在 GitHub Actions 沙箱中为 AI 智能体提供受控的 MCP 工具访问,统一管理多个后端 MCP 服务器。

限制:部分 gateway 配置字段(port、apiKey、domain、startupTimeout、toolTimeout、payloadDir)已校验解析但尚未完全实现;payloadSizeThreshold 在 JSON stdin 中不支持,需用 CLI 标志或环境变量;JSON stdin 不支持 command 字段。其余细节暂未提供。