【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载在 opencodex 的 Cursor 桥接Browser-under-Cursor场景中代理需要把 Codex / Responses 侧的工具注入到 Cursor 模型的可调用目录中。本文基于 devlog/_fin/260711_cursor_browser_bridge/004_fix_mcp_tools_channel.md 这一修复记录完整还原工具注入失败 → 误判通道不兼容 → 重新定位为编码形状错误 → 修复并线上验证的全过程。读完你将掌握Cursor AgentRunRequest 协议中mcp_toolsMcpTools包装与RequestContext.tools两条工具广告通道的区别、protobuf 序列化形状错误wire type 7如何让通道被误判废弃以及如何通过隔离第二代理进行可复现的线上实验。问题症状模型看不见注入的工具在 Cursor 客户端下opencodex 需要把自身的客户端工具如exec_command、read_file、apply_patch等 Responses 风格工具注入给模型调用以驱动浏览器等操作。修复前的表现非常明确无论注入时使用裸名称、mcp_前缀名称、provider 标识符opencodex还是通过mcp_instructions附带匹配的 serverName模型都zero tool calls——不发起任何工具调用模型直接报告工具不可用并回退使用 Cursor 原生的 Shell 工具唯一的例外是当注入发生在AgentRunRequest.mcp_tools顶层通道McpTools包装时工具才真正进入模型的可调用目录。线上端到端验证纯生产代码、无脚手架确认了两个模型家族都能命中注入工具cursor/gpt-5.6-luna - FINAL function_call run_probe {note:hi} cursor/claude-4.5-sonnet - FINAL function_call run_probe {note:hi}也就是说根因不是provider 身份、不是工具命名、不是mcp_instructions而是opencodex 此前只通过 native-exec 的requestContextArgsRequestContext.tools广告客户端工具而 Cursor不会把该通道的工具注册进模型的可调用目录。根因为什么 RequestContext.tools 通道不够opencodex 的 Cursor 适配器有两条工具广告路径RequestContext.toolsnative-exec requestContextArgs随 native exec 的requestContextArgs携带用于声明代理侧可执行的原生工具文件、Shell、MCP、网络等。该通道对 Cursor 原生工具有效但对 Responses 客户端工具注入无效——Cursor 不会将RequestContext.tools中的条目注册进模型的可调用目录。AgentRunRequest.mcp_toolsMcpTools包装AgentRunRequest的顶层字段protobuf 中为 field 4McpTools包装Cursor 会据此把注入工具注册为可调用。这是本次修复补上的通道。修复后的策略是双通道并存RequestContext.tools广告保留作为第二通道同时把同一份工具定义镜像进mcp_tools。从源码结构看live-transport.ts中buildCursorToolDefinitions(cursorVisibleTools, activeRequest.toolChoice)live-transport.ts负责生成 native-exec 侧的工具定义而请求编码器 protobuf-request.ts 复用同一套工具定义构造mcp_tools。历史误判Phase 45 为何错误废弃了这个通道修复记录揭示了一个典型的排障陷阱——通道本身没有被协议拒绝而是序列化形状错了。此前 Phase 42 也尝试过把工具镜像进AgentRunRequest.mcp_tools但线上 Cursor 解析器直接崩溃parse binary: illegal tag: field no 13 wire type 7wire type 7 在 protobuf 二进制编码中是非法 wire type合法类型只有 0/1/2/3/4/5这明确指向序列化缺陷字段被以错误的形状赋值编码出的二进制非法。但当时的 RCA 结论见 devlog/_fin/350_cursor-provider-add/129_phase45-cursor-tool-wire-compat-live-rca.md把现象误读为顶层mcp_tools镜像对此客户端路径不兼容于是做出了保守决策不发送顶层mcp_tools仅保留RequestContext.tools广告并加了一条断言run.mcpTools toBeUndefined。本次修复推翻了这一结论这是错误形状的赋值而非通道被拒绝。用正确的McpToolsSchema包装编码create(McpToolsSchema, { mcpTools: mcpToolDefs })即可产出合法的请求——在 gpt-5.6-luna 和 claude-4.5-sonnet 上均无解析崩溃。独立的佐证来自真实 Cursor 客户端确实读取该通道agent-vibes 的 sol 搜索器 Poincare 解析AgentRunRequest.mcp_toolsTier 2 事实。修复实现正确填充 mcp_tools 通道修复已合入 src/adapters/cursor/protobuf-request.ts 的buildPreparedCursorRunRequestencodeCursorRunRequest为其返回裸字节的兼容包装见 protobuf-request.ts。核心逻辑位于 protobuf-request.ts// 提升到 mcp_tools spread 之外让 token 估算读到与 wire 相同的一份过滤后定义 const mcpToolDefs buildCursorToolDefinitions(visibleTools, request.toolChoice);随后在构造AgentRunRequest时protobuf-request.ts// 将客户端Responses工具定义镜像进顶层 AgentRunRequest.mcp_tools 通道。 // 仅通过 native-exec requestContextArgsRequestContext.tools广告是不够的 // cursor 模型会把这些工具报告为不可用并回退到原生工具。 // 填充 mcp_tools 才能把它们注册进模型的可调用目录线上验证 // gpt-5.6-luna 与 claude-4.5-sonnet 均实际调用了注入工具。 // Phase 42 尝试过但用错形状赋值导致 Cursor 二进制解析器崩溃 // illegal tag正确的 McpTools 包装是 wire 兼容的两个模型家族均无解析崩溃。 ...(mcpToolDefs.length 0 || request.suppressDefaultCursorToolCatalog true ? { mcpTools: create(McpToolsSchema, { mcpTools: mcpToolDefs }) } : {}),几个实现要点过滤后的同一份定义mcp_tools使用与RequestContext.tools及事件状态clientToolNames相同的cursorToolsForActivePrompt过滤后的可见集合。若直接使用原始request.tools会让mcp_tools暴露事件状态不认识的工具——模型一旦调用就会被当作未知 Responses 工具拒绝。空包装的语义mcpToolDefs.length 0时显式空McpTools包装针对裸 API 调用者会抑制 Cursor 默认原生目录字段缺失则让已识别的 Codex 会话保留默认目录protobuf-request.ts。工具定义构建tool-definitions.ts 的buildCursorToolDefinitions按toolChoice过滤cursorToolAllowedByChoice为每个工具产出McpToolDefinitionname/toolName使用线名tool-naming.tsproviderIdentifier统一为OCX_RESPONSES_TOOL_PROVIDER值opencodex-responsestool-naming.tsinputSchema由encodeCursorInputSchema编码为 protobufValue。线名规则Cursor 侧展示给模型的 MCP 显示名为mcp_providerIdentifier_toolName如mcp_opencodex-responses_exec_command而广告的短名可能被模型原样调用因此normalizeCursorWireName会把显示前缀折叠回广告线名避免工具未找到tool-naming.ts。排障方法学隔离第二代理上的可复现实验修复记录详细说明了如何在不动线上代理的前提下安全实验在一次性第二代理端口 10199上运行使用隔离的OPENCODEX_HOME/CODEX_HOME副本实验后删除令牌实验驱动的是真实/v1/responses请求构建路径而非手写 mock通过环境变量门控env-gated的脚手架逐个验证假设提交前全部移除脚手架Tier-2 的 protobuf 事实由 sol cxc-search 子代理Socrates、Poincare提供mcp_tools field 4McpTools包装RequestContext.mcp_instructions field 14以及可用的opencode-cursor桥接的线形状。这种隔离环境 环境变量门控脚手架 真实请求路径的做法让开发者可以自由改变 wire 形状、验证假设而不影响用户正在运行的 10100 代理会话。验证单测断言更新 线上端到端单元测试断言从 phase45 的run.mcpTools toBeUndefined反转为正向断言。在 tests/providers/cursor/cursor-blob.test.ts 中// 客户端 Responses 工具被镜像进顶层 AgentRunRequest.mcp_tools 载荷 // McpTools 包装使 cursor 模型将其注册为可调用。仅通过 native exec // RequestContext.tools 广告会让模型看不到工具。包装形状 wire 兼容 // 此前的崩溃是错误形状赋值现已修正。 expect(run?.mcpTools?.mcpTools.length).toBe(1); expect(run?.mcpTools?.mcpTools[0]?.toolName).toBe(mcp__fs__read_file);同时 tests/providers/cursor/cursor-native-exec.test.ts 继续断言RequestContext.tools通道仍携带mcp__fs__read_file——双通道均有测试覆盖。工具选择语义buildCursorToolDefinitions对auto/required/allowedTools的过滤由 tests/providers/cursor/cursor-tool-choice.test.ts 与 tests/providers/cursor/cursor-tool-definitions.test.ts 守护。验证矩阵bunx tsc --noEmit # exit 0 bun test tests/cursor-blob.test.ts tests/cursor-request-builder.test.ts \ tests/cursor-tool-definitions.test.ts tests/cursor-native-exec.test.ts # 44 pass 线上端到端gpt-5.6-luna 与 claude-4.5-sonnet 均调用注入工具run_probe残余风险与注意事项覆盖范围mcp_tools通道仅在 gpt-5.6-luna 与 claude-4.5-sonnet 上线上验证。其他模型家族对现已正确编码的该通道未测试包装是标准 protobuf崩溃概率低但发布前建议在 Cursor 全产品线做一次宽泛的线上冒烟。运行中代理用户的线上代理10100需要重启后才生效运行中的会话不会自动获得修复。返回路径未变工具结果回传路径不变既有客户端工具桥function_call浮出 - Codex 执行 - 结果作为历史在下一轮回放。一次完整的多轮浏览器往返node_repl- 结果 - 下一次调用值得单独冒烟但返回路径没有代码改动。提交卫生修复提交在claudecode分支上脚手架被完全移除native-exec.ts/tool-definitions.ts恢复到干净基线被卷入另一会话提交 7f80b053 的OCX_CURSOR_PROBE_*脚手架也在此移除。总结AgentRunRequest.mcp_tools通道的修复是 opencodex Cursor 桥接中工具注入正确性的关键一环RequestContext.tools只对 Cursor 原生工具有效客户端Responses工具必须镜像进mcp_tools的McpTools包装才会进入模型可调用目录。而 Phase 45 的通道不兼容误判提醒我们protobuf 的illegal tag / wire type错误首先指向编码形状缺陷而非通道本身被拒绝——用正确 schema 包装后重新实验才能得出可靠结论。赞分享【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载相关推荐OpenCodex Cursor 路由下 Browser 插件失效的根因分析与修复打通 AgentRunRequest.mcp_tools 工具注册通道OpenCodex Cursor 路由下 Browser 插件失效的根因分析与修复打通 AgentRunRequest.mcp_tools 工具注册通道 导读opencodex Cursor 路由下 Browser 插件不可用根因分析从合成 Provider 广告到 AgentRunRequest.mcp_tools 通道修复opencodex Cursor 路由下 Browser 插件不可用根因分析从合成 Provider 广告到 AgentRunRequest.mcp_toolopencodex Cursor 桥接 mcp_tools 工具通告通道加固实战channel 一致性缺陷修复与回归验证opencodex Cursor 桥接 mcp_tools 工具通告通道加固实战channel 一致性缺陷修复与回归验证 本指南围绕 opencodexUn创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
