Skip to main content
Glama
deenesjakoruzh
drharunyuksel

codex-upwork-mcp-bridge

by drharunyuksel
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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: harness_to_mcp

安装

先决条件：

  • 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 工具结果：

开发

bun install --frozen-lockfile
bun test

许可证

MIT

This server cannot be deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • SwiftOpenAI MCP Server

    jamesrochabrun
    A
    license
    Not graded
    quality
    C
    maintenance
    A universal server that enables MCP-compatible clients (like Claude Desktop, Cursor, VS Code) to access OpenAI's APIs for chat completions, image generation, embeddings, and model listing through a standardized interface.
    17 npm
    7
    MIT

  • mcp-openai-extended

    kent013
    A
    license
    B
    quality
    C
    maintenance
    Extended MCP server for OpenAI with support for GPT-5 family, Codex models, and automatic API endpoint selection, enabling chat interactions via the openai_chat tool.
    1
    10 npm
    MIT