MySQL MCP Server

MySQL MCP Server

site icon
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)

常见问题解答

  1. 工具未显示: 检查 Cursor 配置文件中的命令路径是否正确,确保可执行文件存在并有执行权限
  2. 连接失败: 检查数据库连接信息是否正确,使用调试模式查看详细错误信息
  3. 权限问题: 默认只允许查询操作,检查是否需要启用插入/更新/删除权限

使用教程

使用依赖

安装教程

方法一:直接安装(推荐)

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 查询和执行的详细信息 - 错误和异常情况 - 性能相关信息(如查询执行时间)

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。