Codex 数据库 MCP 方案

方案选型

1. 只读查询（推荐起步）

适用场景：数据分析、排障查数、生成报表 SQL、读 schema——不需要模型改库。

把 MCP 能力限制在”看得见、查得到”，风险最低；多数团队给 Codex 接库的第一步。

2. 研发 / DBA 增强型（Postgres）

适用场景：不仅查数，还需要索引建议、性能诊断、运维辅助（仍建议默认只读，按需逐步放开）。

3. 企业 / 云数仓：厂商官方 MCP

适用场景：BigQuery / Snowflake / MongoDB Atlas 等，需要标准鉴权、审计与托管能力。

4. MySQL 生态

社区实现：mysql_mcp_server（Python，需 3.11+）

注意：MySQL 可写场景，强烈建议先做”只读账号 + 只读工具集”，再考虑放开写入。

4.1 安装

pip install mysql-mcp-server
# 依赖：mcp>=1.0.0, mysql-connector-python>=9.1.0

4.2 环境变量

4.3 只读账号（推荐先建专用账号）

-- 创建只读账号
CREATE USER 'codex_ro'@'localhost' IDENTIFIED BY 'strong_password';
GRANT SELECT ON your_database.* TO 'codex_ro'@'localhost';
FLUSH PRIVILEGES;

-- 若后续需要写入，单独再授权（建议用不同账号）
-- GRANT INSERT, UPDATE, DELETE ON your_database.* TO 'codex_rw'@'localhost';

4.4 Codex config.toml 配置

# ~/.codex/config.toml  或  .codex/config.toml（项目级）

[mcp_servers.mysql]
type    = "stdio"
command = "python"
args    = ["-m", "mysql_mcp_server"]

[mcp_servers.mysql.env]
MYSQL_HOST     = "localhost"
MYSQL_PORT     = "3306"
MYSQL_USER     = "codex_ro"
MYSQL_PASSWORD = "strong_password"
MYSQL_DATABASE = "your_database"

敏感信息建议：生产环境不要把密码明文写入 config.toml，改用 shell 环境变量注入：

export MYSQL_PASSWORD="strong_password"

然后在 config.toml 中引用变量名（Codex 会从环境中查找并传递给 MCP server）。

4.5 可用工具（Tools）

Codex 侧配置

Codex 从以下位置读取 MCP 配置（项目级配置仅在 trusted projects 生效）：

~/.codex/config.toml          # 全局
.codex/config.toml            # 项目级

将对应 MCP server 以 stdio 或 HTTP 方式挂进去即可。参考：OpenAI 开发者文档

安全与治理

MCP 生态出现过恶意 MCP server 与已知漏洞，高权限能力交给 MCP server 会放大供应链/注入/组合漏洞的影响面。

按优先级落地护栏：

1. 权限最小化：数据库专用账号，默认只读；写入需求拆成单独 server/账号（建议加审批）
2. 网络隔离：MCP server 跑在同 VPC/内网，只对 Codex 运行环境开放
3. SQL 防护：
   • 只允许 SELECT
   • 限制可访问的库/表
   • 限制返回行数与执行超时
   • 强制参数化、禁多语句
4. 审计与回放：记录每次 tool 调用（用户、SQL、耗时、影响行数），接到告警
5. 供应链：只用可信仓库/镜像；锁版本、做 hash 校验；定期安全扫描（npm/py 包）

快速选型