codex-mcp-proxy
Provides a proxy layer for Warp to interact with Codex MCP Server, intercepting resources/list and resources/read requests to ensure compatibility.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@codex-mcp-proxyexplain the main function in my project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 一直等待。
Related MCP server: MCP Spine
解决方案
本代理作为中间层:
拦截
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
This server cannot be deployed
Maintenance
Related MCP Connectors
The official MCP Server for the Mux API
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Billing proxy for MCP servers. Adds Stripe and x402 crypto payments without writing billing code.
MCP server for accessing curated awesome list documentation
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProxy that aggregates multiple MCP servers and presents them as a unified interface, allowing clients to access resources from multiple servers transparently.4-
- AlicenseAqualityFmaintenanceA local-first middleware proxy that proxies multiple MCP servers through a single entry with schema minification, semantic routing, security hardening, and state guard.211MIT
- AlicenseNot gradedqualityDmaintenanceProxies MCP requests from Cursor IDE to a custom HTTP server, enabling custom tool integrations.9 npm1ISC
- FlicenseAqualityDmaintenanceUniversal MCP proxy server that discovers, searches, and executes tools across all configured MCP servers from a single entry point.7-