Skip to main content
Glama
jonnyhoo

codex-mcp-proxy

by jonnyhoo

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: secure-mcp-proxy

解决方案

本代理作为中间层:

  • 拦截 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

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

  • MCP server for accessing curated awesome list documentation

  • A basic MCP server to operate on the Postman API.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jonnyhoo/codex-mcp-proxy'

If you have feedback or need assistance with the MCP directory API, please join our Discord server