Codex MCP 安装与使用指南
1. MCP 是什么
MCP 可以理解成 Codex 的“外接工具”。
例如，安装 MySQL MCP 后，Codex 就能通过它查看数据库表结构、执行查询。Codex 本身不会直接连接 MySQL，必须先安装一个支持 MySQL 的 MCP Server。
2. 用你的 MySQL 数据库举例
你的数据库信息：
地址：47.99.178.186
端口：3306
数据库：personal
用户名：未提供，需要自己补上
密码：已提供，但不要写进 Git 或笔记下面使用 mysql-mcp-server，通过环境变量传递数据库配置。这个 MCP Server 支持通过 STDIO 连接，适合在本机给 Codex 使用。
3. 配置 MCP
3.1 配置 MySQL MCP
打开 Codex 配置文件：
~/.codex/config.toml加入下面内容：
[mcp_servers.personal_mysql]
command = "uvx"
args = ["--from", "mysql-mcp-server", "mysql_mcp_server"]
[mcp_servers.personal_mysql.env]
MYSQL_HOST = "47.99.178.186"
MYSQL_PORT = "3306"
MYSQL_USER = "替换成你的数据库用户名"
MYSQL_PASSWORD = "替换成你提供的数据库密码"
MYSQL_DATABASE = "personal"说明：
-
uvx是 Python 工具uv提供的临时运行命令，会自动下载并运行mysql-mcp-server，不需要手动执行pip install。 -
你的 Mac 是 Apple Silicon，Homebrew 默认安装在
/opt/homebrew。先执行brew install uv，然后建议将启动命令写成绝对路径：command = "/opt/homebrew/bin/uvx" -
MYSQL_USER必须换成真实数据库用户名。只知道密码还不能连接数据库。 -
密码只放在本机的
config.toml中，不要提交到 Git，也不要发到群聊或截图中。 -
如果本机没有
uvx，先安装uv，然后再重启 Codex。
3.2 配置其他 MCP
以后安装其他 MCP，先查看该项目 README 中的安装方式、启动命令和环境变量，再在 ~/.codex/config.toml 中新增一个配置块。每个 MCP 使用不同的名称。
Python MCP：
[mcp_servers.example]
command = "uvx"
args = ["--from", "Python包名", "启动入口"]Node.js MCP：
[mcp_servers.example]
command = "npx"
args = ["-y", "npm包名"]本地程序：
[mcp_servers.example]
command = "/绝对路径/程序名"
args = []远程 HTTP MCP：
[mcp_servers.example]
url = "https://example.com/mcp"配置后重启 Codex，输入 /mcp 检查连接状态。
4. 检查是否连接成功
重启 Codex，在输入框执行：
/mcp看到 personal_mysql 已连接后，输入：
使用 personal_mysql 查询 personal 数据库有哪些表，只做只读操作。再进一步查询：
使用 personal_mysql 查看 users 表的表结构，并查询 5 条数据。不要执行 INSERT、UPDATE、DELETE、DROP 或 ALTER。5. 连接失败时检查
按这个顺序排查：
- 数据库用户名和密码是否正确。
- MySQL 是否允许你的电脑访问
47.99.178.186:3306。 - 云服务器安全组、防火墙是否放行 3306 端口。
- 在终端执行
uvx --version，确认uvx可用。 - 修改配置后是否重启 Codex。
- 在 Codex 中重新执行
/mcp查看状态。
5.1 公司内网场景：让 zhps_mysql 使用 ATrust SOCKS5
如果 MySQL 地址是公司内网域名，例如：
obproxy-testdb.ob.testcloud.cic.inter而 ATrust 在本机提供了 SOCKS5 服务：
127.0.0.1:1080那么 Codex 的 MCP 进程不能只依赖 ATrust 的域名规则。MCP 进程需要明确通过本机 SOCKS5 端口访问，否则可能出现内网域名无法解析或连接失败。
当前 ATrust 规则的含义是：
DOMAIN-SUFFIX,cic.inter,公司代理
IP-CIDR,10.197.0.0/16,公司代理,no-resolve这些规则由 ATrust 代理客户端负责处理，不会自动注入到 Codex 启动的 MCP 子进程中。
推荐方案：使用 proxychains-ng 包装单个 MCP
先安装：
brew install proxychains-ng创建专用配置文件，例如：
# /Users/chenweili/.codex/proxychains-zhps.conf
dynamic_chain
proxy_dns
[ProxyList]
socks5 127.0.0.1 1080然后将 zhps_mysql 的启动命令改为：
[mcp_servers.zhps_mysql]
command = "/opt/homebrew/bin/proxychains4"
args = [
"-q",
"-f", "/Users/chenweili/.codex/proxychains-zhps.conf",
"/opt/homebrew/bin/uvx",
"--from", "mysql-mcp-server",
"mysql_mcp_server"
]
startup_timeout_sec = 120
tool_timeout_sec = 120
[mcp_servers.zhps_mysql.env]
MYSQL_HOST = "公司内网 MySQL 地址"
MYSQL_PORT = "3306"
MYSQL_USER = "公司数据库用户名"
MYSQL_PASSWORD = "公司数据库密码"
MYSQL_DATABASE = "aboss_sso_ps"
MYSQL_SQL_MODE = ""说明：
proxychains4只包装zhps_mysql，其他 MCP 不会改变网络路径。proxy_dns很重要，可以避免内网域名仍由本机 DNS 直接解析失败。- 数据库地址继续使用公司内网域名，不要改成公网地址。
ALL_PROXY、HTTPS_PROXY等环境变量不一定被 MySQL 客户端识别，因此不能保证仅靠环境变量生效。- 修改后重启 Codex，再通过
/mcp检查zhps_mysql状态。
如果公司 VPN 已连接但仍无法解析 cic.inter 域名，通常需要使用上述 SOCKS5 包装方式，或者让公司网络提供跳板机/端口转发方案。Codex 的 experimental_environment = "remote" 是将 MCP 放到远程执行环境中运行，不等于让本机 MCP 自动连接公司的 VPN。
sql_mode 不兼容问题
sql_mode 是 MySQL 连接建立时的行为设置。mysql-mcp-server 默认使用：
sql_mode = "TRADITIONAL"TRADITIONAL 会启用较严格的数据校验规则，但公司的 Obproxy/数据库兼容层不支持这个连接初始化设置，因此会返回：
Not supported feature or function在 zhps_mysql.env 中增加：
MYSQL_SQL_MODE = ""表示不额外要求当前 MCP 连接启用 TRADITIONAL。该配置只影响当前连接，不会修改数据库的全局配置。验证结果显示，设置为空后，SELECT 1 可以正常执行。主要进行只读查询时通常没有问题；如果以后执行写入，需要额外注意数据校验行为。
6. 安全建议
- 最好新建一个只读 MySQL 用户给 MCP 使用，不要使用 root。
- 只允许这个用户访问
personal数据库。 - 第一次只执行查询，不要让 MCP 具备写入权限。
- 你的数据库地址和密码已经在聊天中出现过，正式使用前建议更换密码。
7. MCP 查询和统计网站
| 网站 | 适合查看什么 | 统计信息 |
|---|---|---|
| 官方 MCP Registry | 官方收录、版本、安装方式、环境变量 | 基本没有使用量排名 |
| PulseMCP | 搜索和比较 MCP | 预计访问量、热门排名、GitHub Star |
| Smithery | 搜索、安装和托管 MCP | useCount，自建服务还可查看调用分析 |
| Glama | 搜索、在线测试、安全和质量检查 | 质量评分、工具数量、生态规模 |
| MCP.so | 按分类浏览 MCP | 适合发现，使用量统计较少 |
| GitHub、PyPI、npm | 查看源码和软件包 | Star、Fork、Issue、下载量 |
说明：
- 官方 Registry 主要保存 MCP 元数据，不负责托管安装包。
- PulseMCP 的访问量属于估算值，不是精确安装量。
- 使用
uvx在本机运行 MCP 时，网站通常看不到你的实际调用次数。 - 查找 MySQL MCP 时，应同时核对作者、GitHub 仓库和安装包名称，避免安装同名但不同项目的 MCP。
参考：