MySQL MCP Server
AI-to-DB Secure Gateway — 不只是一个 MCP Server，而是 AI 与数据库之间的安全执行网关。
基于 NestJS + TypeScript 构建，通过 MCP 协议为 Claude Code 等 AI 助手提供对 MySQL 数据库的受控访问能力。核心目标是在 AI 的灵活性与数据库的安全性之间建立可信边界。
---
设计理念
传统数据库工具直接暴露执行能力，对 AI 调用者而言风险极高。本项目的核心设计原则：
- 最小权限：工具按风险分级，高危操作默认关闭
- AST 级校验：不依赖关键字匹配，通过 SQL Parser 解析语法树做严格校验
- 可审计：每次操作完整记录，行为可追溯
- 可控执行：AI 可以分析（EXPLAIN）但不能随意破坏
---
快速开始
npm install
cp .env.example .env
# 编辑 .env 填入 MySQL 连接信息
npm run start:dev # 开发模式
npm run build # 构建
npm run start:prod # 生产运行在 Claude Code 中配置
先构建项目：
npm run build使用 claude mcp add 命令注册（推荐，写入用户级全局配置）：
claude mcp add mysql node /path/to/mysql-mcp-nest/dist/main.js \
--scope user \
-e DB_HOST=127.0.0.1 \
-e DB_PORT=3306 \
-e DB_USER=root \
-e DB_PASSWORD=your_password \
-e DB_DATABASE=your_database \
-e PERMISSION_MODE=read_write \
-e AUDIT_LOG_ENABLED=true \
-e AUDIT_LOG_DIR=/path/to/mysql-mcp-nest/logs--scope user：写入~/.claude.json，所有项目均可使用--scope project：写入当前项目的.claude.json，仅当前项目可用
注册后重启 claude，执行 /mcp 验证连接状态：
❯ /mcp
mysql connected在 Codex 中配置
先构建项目：
npm run build使用 codex mcp add 命令注册到 Codex：
codex mcp add mysql \
--env DB_HOST=127.0.0.1 \
--env DB_PORT=3306 \
--env DB_USER=root \
--env DB_PASSWORD=your_password \
--env DB_DATABASE=your_database \
--env PERMISSION_MODE=read_write \
--env AUDIT_LOG_ENABLED=true \
--env AUDIT_LOG_DIR=/path/to/mysql-mcp-nest/logs \
-- node /path/to/mysql-mcp-nest/dist/main.js验证配置是否写入成功：
codex mcp list
codex mcp get mysql注册后重启 Codex，或重新开启一个 Codex 会话，让 MCP 配置生效。
连接成功后即可直接使用：
列出 your_database 中的所有表在 Cursor 中配置
项目已包含 .cursor/mcp.json，Cursor 打开本仓库后会注册 mysql MCP Server：
{
"mcpServers": {
"mysql": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/dist/main.js"],
"envFile": "${workspaceFolder}/.env",
"env": {
"AUDIT_LOG_DIR": "${workspaceFolder}/logs"
}
}
}
}使用前先构建项目，并确认 .env 里已填好 MySQL 连接信息：
npm run build然后重启 Cursor，或在 Cursor Settings → MCP 中刷新/启用 mysql。
