mcp-gateway

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 socket，以便對巢狀的 MCP 伺服器容器進行生命週期控制。

• 請務必在配置中明確設定 GITHUB_PERSONAL_ACCESS_TOKEN，以避免身份驗證權限範圍問題。

• 當與 AWF 搭配使用時，請記得啟用 --enable-host-access 並掛載設定檔所需的磁碟區。