codex-upwork-mcp-bridge
Codex ↔ Upwork MCP Bridge
Eine inoffizielle Kompatibilitätsbrücke für die Verwendung des Upwork-MCP-Servers mit OpenAI Codex und der ChatGPT-Desktopanwendung.
Der Upwork-MCP-Server kann sich in einigen MCP-Clients authentifizieren und funktionieren, während Codex seine Tools nicht bereitstellt oder einen Unexpected response type-Fehler meldet. Diese kleine stdio-Brücke führt mcp-remote aus, beantwortet Upworks Server-zu-Client-Ping-Anfragen lokal und entfernt zwei Cache-Hinweise, die in tools/list-Antworten beobachtet wurden, bevor sie an Codex weitergeleitet werden.
Dies ist eine Community-Problemumgehung, kein offizielles Upwork- oder OpenAI-Projekt. Versuchen Sie zuerst den Upwork-MCP-Endpunkt direkt. Das Kompatibilitätsproblem kann jederzeit upstream behoben werden.
Status
Getestet auf macOS mit Codex CLI 0.149.0, Bun und https://mcp.upwork.com/mcp. Dieselbe Codex-MCP-Konfiguration ist auch für die ChatGPT-Desktopanwendung verfügbar, wenn beide die gemeinsame Codex-Konfiguration verwenden.
Das genaue fehlerhafte Feld wurde noch nicht mit einer minimalen Upstream-Reproduktion isoliert. Die Brücke normalisiert beide Protokollunterschiede, die während des fehlerhaften Austauschs beobachtet wurden:
Es beantwortet JSON-RPC-
ping-Anfragen, die vom Server an den Client gesendet werden.Es entfernt
ttlMs- undcacheScope-Cache-Hinweise aus Tool-Listen-Ergebnissen.
Diese Cache-Hinweise existieren in neueren MCP-Entwürfen; das Interoperabilitätsproblem besteht darin, dass sie zurückgegeben wurden, während eine ältere Protokollrevision ausgehandelt wurde, nicht dass die Felder allgemein ungültig sind.
Related MCP server: harness_to_mcp
Install
Voraussetzungen:
Bun 1.2 oder neuer
Codex CLI
Ein Webbrowser für Upwork OAuth
Klonen und Abhängigkeiten installieren:
git clone https://github.com/drharunyuksel/codex-upwork-mcp-bridge.git
cd codex-upwork-mcp-bridge
bun install --frozen-lockfileRegistrieren Sie die Brücke bei Codex, indem Sie den Beispielpfad durch den absoluten Pfad zu Ihrem Klon ersetzen:
codex mcp add upwork -- bun run /absolute/path/to/codex-upwork-mcp-bridge/src/index.tsWenn Sie bereits einen MCP-Server namens upwork haben, entfernen oder benennen Sie diesen Eintrag um, bevor Sie den Befehl ausführen. Starten Sie Codex und ChatGPT neu, nachdem Sie die MCP-Konfiguration geändert haben. Beim ersten Gebrauch öffnet mcp-remote die OAuth-Autorisierung von Upwork in Ihrem Browser.
Sie können es auch manuell zu ~/.codex/config.toml hinzufügen:
[mcp_servers.upwork]
command = "/absolute/path/to/bun"
args = ["run", "/absolute/path/to/codex-upwork-mcp-bridge/src/index.ts"]
startup_timeout_sec = 60Finden Sie den absoluten Pfad von Bun mit command -v bun.
Verify
codex mcp list
codex mcp get upworkBitten Sie dann Codex, die verfügbaren Upwork-Tools aufzulisten oder eine schreibgeschützte Aktion auszuführen, z. B. Ihr Upwork-Profil anzuzeigen. Vermeiden Sie es, private Tool-Ausgaben zu posten, wenn Sie ein Problem melden.
Remove
codex mcp remove upworkDas Entfernen des Codex-Eintrags entfernt nicht die lokale OAuth-Sitzung von mcp-remote. Konsultieren Sie die mcp-remote-Dokumentation, wenn Sie diese Sitzung ebenfalls löschen möchten.
How it works
Codex / ChatGPT <-- stdio JSON-RPC --> this bridge
|
v
mcp-remote
|
v
https://mcp.upwork.com/mcpDie Brücke ändert nur die beiden beobachteten Kompatibilitätspunkte. Andere JSON-RPC-Nachrichten werden durchgereicht. Protokollverkehr bleibt auf stdout; Diagnosen gehen an stderr, damit sie den MCP-Stream nicht beschädigen können.
Related Codex reports
Dieses Repository behandelt den Upwork-Fall, aber ähnliche Berichte beschreiben, dass Codex MCP-Tool-Ergebnisse ablehnt oder nicht anzeigt, die in anderen Clients funktionieren:
Gültige MCP-Ergebnisse als unerwarteter Antworttyp dekodiert
MCP-Server verbindet sich, aber Tools werden nicht aufgelistet
Development
bun install --frozen-lockfile
bun testLicense
This server cannot be deployed
Maintenance
Related MCP Connectors
The official Upwork MCP server, letting AI agents connect to Upwork and act on your behalf.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA 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.13 npm7MIT
- AlicenseNot gradedqualityDmaintenanceExposes internal tools from agent harnesses (Claude Code, Codex, etc.) as a standard MCP server by intercepting LLM API calls.1MIT
- AlicenseBqualityDmaintenanceExtended 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.112 npmMIT
- AlicenseAqualityBmaintenanceEnables ChatGPT web to use local tools like file reading, command execution, and patch application through an MCP server over OpenAI Secure MCP Tunnel.62MIT