mcp-gateway
管理、部署与调试 GitHub MCP 服务器与网关。编排基于 Docker 的 MCP 容器、排查连接故障、处理身份验证,并整合 Copilot CLI 与 Agentic Workflow Firewall (AWF)。
简介
mcp-gateway 技能为使用模型上下文协议 (MCP) 的工程师提供了一套操作框架。它专为需要在本地或容器化环境中运行 GitHub MCP 服务器的开发者所设计,确保像 GitHub Copilot CLI 与身份验证代理网关之间的无缝集成。此技能简化了 MCP 容器的生命周期管理,使用户能够精确地启动、验证、调试和终止网关实例。
-
通过 Python 脚本自动化部署 MCP 网关 (gh-aw-mcpg) 容器。
-
支持多种传输模式,包括 HTTP、SSE 和基于 stdio 的通信。
-
管理 GitHub 个人访问令牌 (PAT) 和环境特定变量(如 GATEWAY_PORT 和 GATEWAY_API_KEY)的配置。
-
提供健康监控和日志分析,用于检测令牌传递失败或容器退出错误。
-
与 Agentic Workflow Firewall (AWF) 无缝集成,确保主机访问与域名过滤的安全性。
-
原生支持测试 MCP 工具注册以及排查连接错误(如 ECONNREFUSED)。
-
在启动网关容器时,务必通过标准输入 (stdin) 管道传递有效的 JSON 配置,以保持与 v0.0.59+ 架构的兼容性。
-
使用提供的脚本(如 start-gateway.py 和 debug-gateway.py)以获取一致的操作状态报告。
-
确保正确挂载 Docker 套接字,以便对嵌套的 MCP 服务器容器进行生命周期控制。
-
请务必在配置中显式设置 GITHUB_PERSONAL_ACCESS_TOKEN,以避免身份验证权限范围问题。
-
当与 AWF 配合使用时,记得启用 --enable-host-access 并挂载配置文件所需的卷。
仓库统计
- Star 数
- 0
- Fork 数
- 0
- Open Issue 数
- 19
- 主要语言
- Python
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月3日 22:39