Ai2mysql MCP Server

MySQL MCP服务器

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

特性

• 通过MCP协议与客户端通信
• 支持连接MySQL数据库
• 支持查询操作（SELECT、SHOW、DESCRIBE）
• 支持数据操作（插入/更新/删除）
• 权限控制（可配置插入、更新、删除操作）
• 通过环境变量灵活配置
• 调试模式，详细记录到文件中

安装

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

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

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

方法2：手动构建

# Clone the repository
git clone https://github.com/blanplan-ai/ai2mysql-mcp-server.git
cd ai2mysql-mcp-server

# Build the server
go build -o ai2mysql-mcp-server ./cmd/ai2mysql-mcp-server

配置

服务器是使用环境变量配置的。

环境变量

可以设置以下环境变量来配置服务器：

JSON配置示例

下面是一个可以用来设置环境变量的JSON配置示例：

{
  "MYSQL_HOST": "127.0.0.1",
  "MYSQL_PORT": "3306",
  "MYSQL_USER": "root",
  "MYSQL_PASS": "password",
  "DEFAULT_DATABASE": "test",
  "ALLOW_INSERT": "false",
  "ALLOW_UPDATE": "false",
  "ALLOW_DELETE": "false",
  "IS_DEV": "false",
  "LOG_PATH": "/tmp/ai2mysql.log"
}

配置说明：

• 所有布尔型配置项都使用字符串“true”或“false”
• 在生产环境中，建议禁用is_DEV以防止敏感信息泄漏
• 建议根据实际需要限制INSERT/UPDATE/DELETE权限
• 应使用环境变量配置密码等敏感信息

用法

启动服务器

安装后运行服务器：

# Run with default settings
ai2mysql-mcp-server

# Run with environment variables
MYSQL_HOST=127.0.0.1 MYSQL_USER=root MYSQL_PASS=password ai2mysql-mcp-server

# Enable development mode
IS_DEV=true ai2mysql-mcp-server

启用开发模式后，详细日志将输出到配置的日志文件中（默认值： /tmp/ai2mysql.log)，包括完整的请求、响应和错误信息。

与光标一起使用

此服务器旨在与支持MCP协议的客户端（如Cursor）一起工作。

在Cursor中，您可以使用以下配置启用MySQL MCP服务器：

{
  "mcpServers": {
    "mysql-mcp-server": {
      "command": "ai2mysql-mcp-server",
      "args": [],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "password",
        "DEFAULT_DATABASE": "test",   // Default database, optional
        "ALLOW_INSERT": "false",      // Allow insert operations, optional
        "ALLOW_UPDATE": "false",      // Allow update operations, optional
        "ALLOW_DELETE": "false",      // Allow delete operations, optional
        "IS_DEV": "false"             // Enable development mode, optional
      }
    }
  }
}

添加配置后，您可以使用以下工具：

1. mysql_query：执行SQL查询操作

- 参数： sql -SQL查询语句（SELECT、SHOW、DESCRIBE）

1. mysql_execute：执行SQL数据操作

- 参数： sql -SQL数据操作语句（插入/更新/删除）

发展

项目结构

ai2mysql-mcp-server/
└── cmd/
    └── ai2mysql-mcp-server/  # Server entry
        └── main.go          # Main program

依赖项

• go sql驱动程序/mysql：MySQL驱动程序
• ThinkInAIXYZ/go mcp：MCP协议库

调试和故障排除

调试模式

设置环境变量 IS_DEV=true 要启用调试模式，请执行以下操作：

IS_DEV=true ai2mysql-mcp-server

在调试模式下，服务器将向指定的日志文件输出详细的日志，包括：

• 所有收到的请求和发送的响应
• 详细的SQL查询和执行信息
• 错误和异常情况
• 性能相关信息（如查询执行时间）

常见问题

如果在Cursor中遇到问题：

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

许可证

MIT许可证