工程开发
mcp-gateway avatar

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
在 GitHub 查看