MySQL 的 MCP 服务器

赞助商 — Bloome

正在使用 mcp-server-mysql 让你的 AI 查询 MySQL？Bloome 能将这一能力带给你的整个团队——这是一个 AI 代理即时通讯平台，AI 代理是聊天中的成员。连接你的 MCP 工具，让代理在同一个线程中为所有人检查 schema、运行查询并回答数据问题。无需本地设置，云端运行，支持网页端和移动端。

---

这个 MCP 服务器让 Claude 和其他 LLM 能够访问 MySQL——检查 schema、运行查询，并可选地写入数据，全部通过 Model Context Protocol 实现。

主要特性

• 默认只读 — 通过环境变量选择启用写操作
• Claude Code 集成 — 针对 Anthropic 的 Claude Code CLI 优化
• SSH 隧道支持 — 内置对远程数据库的支持
• 多数据库模式 — 无需重新连接即可跨多个数据库查询
• Schema 级权限 — 按数据库的读/写控制
• PII 脱敏 — 自动屏蔽结果中的敏感数据
• 远程模式 — 基于 HTTP 传输，使用 bearer token 认证
• SSL/TLS 支持 — 加密连接，可选 mTLS

环境要求

• Node.js v20+
• MySQL 5.7+（推荐 8.0+）
• 具有相应权限的 MySQL 用户

快速安装

Claude Code（最简单）：

claude mcp add mcp_server_mysql \
  -e MYSQL_HOST="127.0.0.1" \
  -e MYSQL_PORT="3306" \
  -e MYSQL_USER="root" \
  -e MYSQL_PASS="your_password" \
  -e MYSQL_DB="your_database" \
  -- npx @benborla29/mcp-server-mysql

Claude Desktop / 其他客户端：

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

所有写操作默认禁用。可通过 ALLOW_INSERT_OPERATION=true、ALLOW_UPDATE_OPERATION=true、ALLOW_DELETE_OPERATION=true 启用。

文档

• 安装指南 — Smithery、Cursor、Codex、Claude Code、本地仓库、远程模式
• 配置与环境变量 — 所有环境变量、高级配置
• 多数据库模式 — 查询多个数据库
• PII 脱敏 — 自动数据屏蔽
• 测试 — 测试设置与运行
• 故障排查 — 常见问题与修复
• 更新日志

工具与资源

工具：mysql_query 执行 SQL 查询。默认只读。写操作按标志启用。

资源：mysql://tables 列出已连接数据库的所有表和列元数据。

参与贡献

欢迎在 github.com/benborla/mcp-server-mysql 提交 PR。

git clone https://github.com/benborla/mcp-server-mysql.git
pnpm install
pnpm run build
pnpm test

许可证

MIT — 详见 LICENSE。