MCP Server for MySQL based on NodeJS

MySQL MCP 服务

赞助商 — Bloome

使用 mcp-server-mysql 让 AI 查询 MySQL？Bloome 将此能力带给整个团队——这是一个 AI Agent IM 平台，AI Agent 是聊天成员。连接 MCP 工具，让 Agent 在同一个对话串中检查架构、运行查询，并为所有人解答数据问题。无需本地设置，在云端、网页和移动设备上运行。

---

MCP 服务可让 Claude 和其他大模型访问 MySQL——通过 Model Context Protocol 检查架构、运行查询，并可选择写入数据。

主要功能

• 默认只读 — 通过环境变量标志选择启用写入操作
• Claude Code 集成 — 针对 Anthropic 的 Claude Code CLI 优化
• SSH 隧道支持 — 内置远程数据库支持
• 多数据库模式 — 无需重新连接即可跨多个数据库查询
• 架构级权限 — 按数据库控制读写权限
• PII 脱敏 — 自动屏蔽结果中的敏感数据
• 远程模式 — 使用 bearer token 身份验证的 HTTP 传输
• 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。