Codex ↔ Upwork MCP Bridge

一个非官方的兼容性桥接，用于将 Upwork 的 MCP 服务器与 OpenAI Codex 和 ChatGPT 桌面应用程序一起使用。

Upwork 的 MCP 服务器可以在某些 MCP 客户端中进行身份验证和工作，而 Codex 无法暴露其工具或报告 Unexpected response type 错误。这个小型 stdio 桥接运行 mcp-remote，在本地回答 Upwork 的服务器到客户端 ping 请求，并在转发给 Codex 之前移除在 tools/list 响应中观察到的两个缓存提示。

这是一个社区变通方案，不是官方的 Upwork 或 OpenAI 项目。请先直接尝试 Upwork 的 MCP 端点。兼容性问题可能随时在上游修复。

状态

已在 macOS 上使用 Codex CLI 0.149.0、Bun 和 https://mcp.upwork.com/mcp 进行测试。当两者使用共享的 Codex 配置时，相同的 Codex MCP 配置也可用于 ChatGPT 桌面应用程序。

尚未通过最小的上游复现隔离出确切失败的字段。该桥接规范了失败交换期间观察到的两个协议差异：

• 它回答从服务器发送到客户端的 JSON-RPC ping 请求。

• 它从工具列表结果中移除 ttlMs 和 cacheScope 缓存提示。

这些缓存提示存在于较新的 MCP 草案中；互操作性问题在于它们是在协商较旧协议修订版时返回的，而不是这些字段普遍无效。

Related MCP server: MCP Token Bridge

安装

先决条件：

• Bun 1.2 或更高版本

• Codex CLI

• 用于 Upwork OAuth 的网页浏览器

克隆并安装依赖：

git clone https://github.com/drharunyuksel/codex-upwork-mcp-bridge.git
cd codex-upwork-mcp-bridge
bun install --frozen-lockfile

使用 Codex 注册桥接，将示例路径替换为你的克隆的绝对路径：

codex mcp add upwork -- bun run /absolute/path/to/codex-upwork-mcp-bridge/src/index.ts

如果你已经有一个名为 upwork 的 MCP 服务器，请在运行命令之前删除或重命名该条目。更改 MCP 配置后，请重启 Codex 和 ChatGPT。首次使用时，mcp-remote 会在你的浏览器中打开 Upwork 的 OAuth 授权。

你也可以手动将其添加到 ~/.codex/config.toml：

[mcp_servers.upwork]
command = "/absolute/path/to/bun"
args = ["run", "/absolute/path/to/codex-upwork-mcp-bridge/src/index.ts"]
startup_timeout_sec = 60

使用 command -v bun 查找 Bun 的绝对路径。

验证

codex mcp list
codex mcp get upwork

然后让 Codex 列出可用的 Upwork 工具或执行只读操作，例如显示你的 Upwork 个人资料。报告问题时，请避免发布私有工具输出。

移除

codex mcp remove upwork

删除 Codex 条目不会删除 mcp-remote 的本地 OAuth 会话。如果你还想清除该会话，请查阅 mcp-remote 文档。

工作原理

Codex / ChatGPT  <-- stdio JSON-RPC -->  this bridge
                                             |
                                             v
                                        mcp-remote
                                             |
                                             v
                                 https://mcp.upwork.com/mcp

该桥接仅更改了观察到的两个兼容性点。其他 JSON-RPC 消息会直接通过。协议流量保留在 stdout 上；诊断信息发送到 stderr，以免破坏 MCP 流。

相关的 Codex 报告

此仓库解决了 Upwork 的情况，但类似的报告描述了 Codex 拒绝或未能显示在其他客户端中可用的 MCP 工具结果：

• 有效的 MCP 结果被解码为意外响应类型

• 符合规范的注释被 Codex 拒绝

• MCP 服务器已连接但未列出工具

• 请求更好的 MCP 诊断

开发

bun install --frozen-lockfile
bun test

许可证

MIT