29-将Codex作为MCP Server
29 将Codex作为MCP Server——AI Agent的互操作新纪元一、引言在前几篇文章中，我们一直把Codex当作MCP Client——它连接各种MCP Server来获取工具能力。但你是否想过，Codex本身也可以成为一个MCP Server？想象一下这个场景：Claude Code在处理一个复杂项目时，需要Codex的代码理解和重构能力Cursor的Agent在处理前端代码时，需要Codex的Windsurf Flow多步推理OpenAI Agents SDK的某个Agent需要调用Codex的对话能力来处理特定任务Codex作为MCP Server，让这一切成为可能。它不再是单向的工具消费者，而是双向协作网络中的一个节点。在Windsurf Codex中，MCP Server模式的正式命令是codex mcp-server（在某些版本中也可能称为windsurf mcp-server）。本文统一使用codex。二、codex mcp-server 命令详解2.1 基本用法# 启动MCP Server模式（stdio传输）codex mcp-server# 指定传输方式codex mcp-server--transportstdio# 指定端口（HTTP模式）codex mcp-server--transporthttp--port87652.2 配置参数参数类型默认值说明--transportstdio/http/ssestdio传输方式--portint8765HTTP/SSE模式下的监听端口--hoststringlocalhost绑定地址--log-levelstringinfo日志级别：debug/info/warn/error--allowed-domainsstring*允许调用的域名白名单2.3 启动方式对比方式一：stdio模式（最常用）codex mcp-server--transportstdio# 等待其他AI应用通过stdin/stdout通信方式二：HTTP模式（远程调用）codex mcp-server--transporthttp--port8765# 其他应用通过HTTP调用# http://localhost:8765/mcp方式三：永久后台运行# Windowsstart /B codex mcp-server--transporthttp--port8765# macOS/Linuxnohupcodex mcp-server--transporthttp--port8765/tmp/codex-mcp.log21三、暴露的工具详解当Codex以MCP Server模式运行时，它向外界暴露一套标准化的MCP工具。目前主要有两个核心工具：3.1 codex() —— 启动新对话启动一个全新的Codex对话上下文，适合独立的查询或任务。工具定义：{"name":"codex","description":"Start a new conversation with Codex AI. Use this for independent queries or tasks that need Codex's capabilities.","inputSchema":{"type":"object","properties":{"message":{"type":"string","description":"The message to send to Codex"},"model":{"type":"string","description":"Model to use (default: codex default model)","default":""},"temperature":{"type":"number","description":"Response creativity (0.0-1.0)","default":0.7}},"required":["message"]}}调用示例：{"jsonrpc":"2.0","method"
