Codex MCP Gateway

codex mcp网关

远程MCP服务器公开GitHub支持的工具，用于启动Codex任务、审查拉取请求、门控合并和触发验证。使用SSE回退实现MCP流式HTTP传输。

特性

• initialize, tools/list，以及 tools/call 单个JSON-RPC端点 /mcp 路线
• 可选的流式HTTP响应 text/event-stream 运输
• 食典委和PR活动的事件排放（Codex.task.\*和PR.\*）
• GitHub工作流调度、PR审查、关卡评估、合并和验证触发工具
• 承载令牌身份验证、源验证和速率限制
• 基于Zod的工具参数运行时验证

入门

1. 安装依赖项：

   npm install

1. 复制环境变量并配置：

   cp .env.example .env
   # edit .env with AUTH_TOKEN, GITHUB_TOKEN, ALLOWED_ORIGINS, etc.

1. 构建并运行：

   npm run build
   npm start

或者以实时重新加载的方式在开发模式下启动：

   npm run dev

MCP端点

• POST /mcp --支持JSON-RPC 2.0有效载荷的流式HTTP端点
• GET /mcp --为服务器推送的事件打开SSE流
• GET /sse --旧别名重定向到 /mcp

在请求中包含以下标题：

• Authorization: Bearer --比赛 AUTH_TOKEN 从配置
• MCP-Protocol-Version: 2025-06-18
• Mcp-Session-Id --初始后需要 initialize 握手

初始化

curl -X POST http://localhost:8080/mcp \
  -H "Authorization: Bearer change-me" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{"tools":{}},"clientInfo":{"name":"curl","version":"0.0.1"}}}'

列出工具

curl -X POST http://localhost:8080/mcp \
  -H "Authorization: Bearer change-me" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -H "Mcp-Session-Id: " \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

调用工具

curl -X POST http://localhost:8080/mcp \
  -H "Authorization: Bearer change-me" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -H "Mcp-Session-Id: " \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"launch_codex_task","arguments":{"owner":"your-org","repo":"your-repo","ref":"main","instruction":"Add tests"}}}'

码头工人

docker build -t codex-mcp-gateway .
docker run --env-file .env -p 8080:8080 codex-mcp-gateway

测试

npm test

连接器配置

在ChatGPT连接器中，配置一个新的MCP服务器：

• 统一资源定位符: https:///mcp
• 标头：包括 Authorization 持票人代币和 MCP-Protocol-Version
• SSE URL：可选；服务器自动支持GET /mcp

许可证

麻省理工学院