AI导哈

代码任务网关服务

一个基于GitHub的远程MCP服务器，用于启动Codex任务、审查拉取请求、控制合并和触发验证，支持JSON-RPC端点和流式HTTP响应。

  • by mind-protocol
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mind-protocol/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

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

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

  3. 构建并运行：

    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> --比赛 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: <session-id-from-initialize>" \
  -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: <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://<host>/mcp
  • 标头：包括 Authorization 持票人代币和 MCP-Protocol-Version
  • SSE URL：可选；服务器自动支持GET /mcp

许可证

麻省理工学院

相关 MCP