
MySQL MCP Server

2025.04.05
0
Go数据库连接SQL操作数据库
MySQL MCP Server 是一个基于 Model Context Protocol (MCP) 的 MySQL 数据库连接服务器,支持通过 stdio 方式与客户端通信,允许执行 SQL 查询和数据操作。它提供了灵活的配置选项和权限控制,适用于需要与 MySQL 数据库交互的各种场景。
View on GitHub
Overview
基本能力
产品定位
MySQL MCP Server 是一个数据库连接服务器,旨在通过 MCP 协议提供对 MySQL 数据库的访问和操作能力。
核心功能
- 通过 MCP 协议与客户端通信
- 支持连接多个 MySQL 数据库
- 支持查询操作(SELECT)
- 支持数据操作(INSERT/UPDATE/DELETE)
- 权限控制(可分别配置查询、插入、更新、删除权限)
- 支持通过环境变量或JSON配置文件进行灵活配置
- 支持调试模式,将详细日志输出到文件
适用场景
- 需要与 MySQL 数据库交互的应用程序
- 需要灵活配置数据库连接和权限控制的场景
- 开发过程中需要调试和监控数据库操作的场景
工具列表
mcp_mysql_query
: 执行 SQL 查询操作- 参数:
sql
- SQL 查询语句 mcp_mysql_execute
: 执行 SQL 数据操作- 参数:
sql
- SQL 数据操作语句(INSERT/UPDATE/DELETE)
常见问题解答
- 工具未显示: 检查 Cursor 配置文件中的命令路径是否正确,确保可执行文件存在并有执行权限
- 连接失败: 检查数据库连接信息是否正确,使用调试模式查看详细错误信息
- 权限问题: 默认只允许查询操作,检查是否需要启用插入/更新/删除权限
使用教程
使用依赖
- go-sql-driver/mysql: MySQL 驱动
- ThinkInAIXYZ/go-mcp: MCP 协议库
安装教程
方法一:直接安装(推荐)
go install github.com/blanplan-ai/ai2mysql-mcp-server/cmd/ai2mysql-mcp-server@latest
安装完成后,可以直接在命令行中运行:
ai2mysql-mcp-server
方法二:手动构建
# 克隆仓库
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
调试方式
使用 -debug=true
参数启动服务器可以启用调试模式:
ai2mysql-mcp-server -debug=true
调试模式下,服务器会将详细的日志输出到 /tmp/ai2mysql.log
文件中,包括:
- 所有收到的请求和发送的响应
- SQL 查询和执行的详细信息
- 错误和异常情况
- 性能相关信息(如查询执行时间)