MySQL MCP 服务器

用于与 MySQL 数据库进行交互的 MCP 服务器。

此服务器支持执行只读查询（query）以及最终回滚的写入查询（test_execute）。

<a href="https://glama.ai/mcp/servers/kucglstegf"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=859361716,2601112304&fm=3081&app=3081&f=PNG?w=760&h=400" alt="MySQL Server MCP 服务器" /> </a>

配置

环境变量

在 ~/.mcp/.env 文件中添加以下环境变量：

MYSQL_HOST=host.docker.internal  # 从 Docker 容器访问主机服务的主机名
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password

注意：host.docker.internal 是一个特殊的 DNS 名称，用于从 Docker 容器访问主机上的服务。 当连接到运行在主机上的 MySQL 服务器时，请使用此设置。 如果连接到其他 MySQL 服务器，请更改为主机名。

mcp.json 配置

{
  "mcpServers": {
    "mysql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--add-host=host.docker.internal:host-gateway",
        "--env-file",
        "/Users/username/.mcp/.env",
        "ghcr.io/xiangma9712/mcp/mysql"
      ]
    }
  }
}

使用方法

启动服务器

docker run -i --rm --add-host=host.docker.internal:host-gateway --env-file ~/.mcp/.env ghcr.io/xiangma9712/mcp/mysql

注意：如果您使用的是 OrbStack，host.docker.internal 是自动支持的，因此可以省略 --add-host 选项。 虽然 Docker Desktop 通常也自动支持这一点，但建议添加 --add-host 选项以提高可靠性。

可用命令

1. 执行只读查询

{
  "type": "query",
  "payload": {
    "sql": "SELECT * FROM your_table"
  }
}

响应：

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "example"
    }
  ]
}

2. 测试查询执行

{
  "type": "test_execute",
  "payload": {
    "sql": "UPDATE your_table SET name = 'updated' WHERE id = 1"
  }
}

响应：

{
  "success": true,
  "data": "The UPDATE SQL query can be executed."
}

3. 列出表

{
  "type": "list_tables"
}

响应：

{
  "success": true,
  "data": ["table1", "table2", "table3"]
}

4. 描述表

{
  "type": "describe_table",
  "payload": {
    "table": "your_table"
  }
}

响应：

{
  "success": true,
  "data": [
    {
      "Field": "id",
      "Type": "int(11)",
      "Null": "NO",
      "Key": "PRI",
      "Default": null,
      "Extra": ""
    },
    {
      "Field": "name",
      "Type": "varchar(255)",
      "Null": "YES",
      "Key": "",
      "Default": null,
      "Extra": ""
    }
  ]
}

实现细节

• 使用 TypeScript 实现
• 使用 mysql2 包
• 作为 Docker 容器运行
• 通过标准输入接收 JSON 命令
• 通过标准输出返回 JSON 响应
• 使用 host.docker.internal 连接到主机 MySQL（兼容 OrbStack 和 Docker Desktop）

安全注意事项

• 使用环境变量管理敏感信息
• SQL 注入防护是实现者的责任
• 生产使用需要适当的网络配置
• 连接到主机服务时需要适当设置防火墙