Codex MCP Proxy
一个轻量级 MCP 代理服务器，用于解决 Codex MCP Server 与 Warp 的兼容性问题。
🤖 For LLM Integration: See LLM_GUIDE.md for detailed tool descriptions, error handling, and workflow examples.
问题背景
Warp 在连接 MCP Server 时会发送 resources/list 请求，但 Codex 上游实现仅打印日志而不返回响应，导致 Warp 一直等待。
解决方案
本代理作为中间层：
- 拦截
resources/list请求，返回空列表 - 拦截
resources/read请求，返回资源未找到错误 - 透传所有其他请求到
codex mcp-server
安装
npm install
npm run build使用方法
在 Warp 中配置
编辑 MCP 配置文件：
{
"mcpServers": {
"codex": {
"type": "stdio",
"command": "node",
"args": ["C:/Users/Administrator/Desktop/sicko/codex-mcp-proxy/dist/index.js"]
}
}
}环境变量
CODEX_MCP_DEBUG=1- 启用调试日志
直接运行
npm start
# 或开发模式
npm run dev开发
# 安装依赖
npm install
# 运行测试
npm test
# 运行测试并查看覆盖率
npm run test:coverage
# 类型检查
npm run typecheck
# 构建
npm run build架构
┌─────────┐ ┌──────────────┐ ┌─────────────────┐
│ Warp │────▶│ codex-mcp- │────▶│ codex mcp-server│
│ (Client)│◀────│ proxy │◀────│ (upstream) │
└─────────┘ └──────────────┘ └─────────────────┘
│
▼
拦截 resources/*
返回空列表/错误测试覆盖率
- Parser: 100%
- Server: 80%+
- Types: 100%
Error Handling
错误响应包含 LLM 友好的详细信息：
{
"error": {
"code": -32603,
"message": "Codex service is not available",
"data": {
"detail": "The Codex backend process is not running or failed to start.",
"suggestion": "Wait a few seconds and retry. If the problem persists, restart the MCP server.",
"retryable": true,
"method": "tools/call"
}
}
}License
MIT
