MySQL MCP 服务器

一个基于 go-mcp 的 MySQL 数据库连接服务器，支持通过 stdio 与客户端通信，允许执行 SQL 查询和数据操作。

功能

• 通过 MCP 协议与客户端通信
• 支持连接到 MySQL 数据库
• 支持查询操作（SELECT、SHOW、DESCRIBE）
• 支持数据操作（INSERT/UPDATE/DELETE）
• 权限控制（可配置插入、更新、删除操作）
• 灵活的环境变量配置
• 开发模式下的详细日志记录

安装

方法 1：直接安装（推荐）

使用 Go 的 install 命令从 GitHub 直接安装：

go install github.com/blanplan-ai/ai2mysql-mcp-server/cmd/ai2mysql-mcp-server@latest

方法 2：手动构建

# 克隆仓库
git clone https://github.com/blanplan-ai/ai2mysql-mcp-server.git
cd ai2mysql-mcp-server

# 构建服务器
go build -o ai2mysql-mcp-server ./cmd/ai2mysql-mcp-server

配置

服务器通过环境变量进行配置。

环境变量说明

• MYSQL_HOST：MySQL 服务的主机地址，默认为 "localhost"。
• MYSQL_PORT：MySQL 服务的端口号，默认为 3306。
• MYSQL_USER：连接 MySQL 的用户名。
• MYSQL_PASSWORD：连接 MySQL 的密码。
• DEFAULT_DATABASE：默认使用的数据库名称。
• ALLOW_INSERT：允许插入操作，值为 "true" 或 "false"。
• ALLOW_UPDATE：允许更新操作，值为 "true" 或 "false"。
• ALLOW_DELETE：允许删除操作，值为 "true" 或 "false"。
• IS_DEV：启用开发模式，值为 "true" 或 "false"。启用后会输出详细日志。

使用

启动服务器

# 基本启动
ai2mysql-mcp-server

# 开发模式
IS_DEV=true ai2mysql-mcp-server

与 Cursor 配合使用

在 Cursor 中配置工具时，需要指定可执行文件的路径，并设置相应的环境变量。例如：

{
  "name": "MySQL MCP",
  "command": "/path/to/ai2mysql-mcp-server",
  "env": {
    "MYSQL_HOST": "localhost",
    "MYSQL_PORT": "3306",
    "MYSQL_USER": "root",
    "MYSQL_PASSWORD": "password",
    "DEFAULT_DATABASE": "testdb",
    "ALLOW_INSERT": "true",
    "ALLOW_UPDATE": "true",
    "ALLOW_DELETE": "true",
    "IS_DEV": "false"
  }
}

执行 SQL 操作

• 查询操作：

  echo "mysql_query --sql='SELECT * FROM users'" | ai2mysql-mcp-server
  

• 数据操作：

  echo "mysql_execute --sql='INSERT INTO users(name,email) VALUES('John','john@example.com')'" | ai2mysql-mcp-server
  

开发

项目结构

ai2mysql-mcp-server/
└── cmd/
    └── ai2mysql-mcp-server/  # 服务器入口
        └── main.go          # 主程序

依赖项

• go-sql-driver/mysql：MySQL 驾驶员
• ThinkInAIXYZ/go-mcp：MCP 协议库

调试和故障排除

开发模式

设置环境变量 IS_DEV=true 启用调试模式：

IS_DEV=true ai2mysql-mcp-server

在调试模式下，服务器会输出详细日志，包括接收的所有请求、发送的所有响应、详细的 SQL 查询和执行信息、错误条件以及性能相关信息（如查询执行时间）。

常见问题

1. 工具未显示：检查命令路径是否正确，确保可执行文件存在且有执行权限。
2. 连接失败：检查数据库连接信息是否正确，使用调试模式查看详细错误消息。
3. 权限问题：默认情况下只允许查询操作，检查是否需要启用插入、更新或删除权限。

许可证

MIT License