Codex 中转介绍

🔗 MCP 扩展服务

通过 Model Context Protocol 给 Codex 接入文件系统、Git、数据库等外部能力。

什么是 MCP

Model Context Protocol(MCP)是 Anthropic 提出的开放协议,让 AI Agent 通过标准化接口调用外部工具和数据源。Codex 原生支持 MCP,意味着你可以让它直接读写文件、查询数据库、操作 Git,而不用复制粘贴。

启用 MCP

~/.codex/config.toml 里启用 MCP:

[mcp]
enabled = true

常用 MCP Server

Filesystem — 读写本地文件

[[mcp.servers]]
name = "filesystem"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/code"]

配置后 Codex 可以:

  • 读取项目里任意文件
  • 创建、修改、删除文件
  • 跨文件搜索代码

Git — 操作 Git 仓库

[[mcp.servers]]
name = "git"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-git", "--repository", "/path/to/repo"]

Codex 可以查看 commit 历史、生成 diff、写 commit message、创建分支。

SQLite — 查询数据库

[[mcp.servers]]
name = "sqlite"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sqlite", "--db-path", "/path/to/database.db"]

Codex 可以执行 SQL、分析表结构、生成统计报表。

GitHub — GitHub API 操作

[[mcp.servers]]
name = "github"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "your_token" }

Codex 可以创建 PR、回复 issue、读取仓库元数据。

使用示例

配置好 filesystem MCP 后,直接在 Codex 里说:

> 帮我看下 src/api/user.ts,把里面的 any 类型都改成具体类型

Codex 会自动调用 MCP 读取文件 → 分析 → 重写 → 写回,全程不需要你复制粘贴。

验证 MCP 是否生效

codex mcp list

会列出当前可用的所有 MCP Server。如果列表为空,检查 config.toml 语法和 npx 是否可用。

自己写 MCP Server

MCP 协议非常简单(基于 stdio + JSON-RPC),任何语言都能实现。参考:

推荐组合:filesystem + git + github 三件套,覆盖 90% 的开发场景。