MySQL MCP Server

MySQL MCP 服务

一个模型上下文协议（MCP）服务，可通过自然语言查询为 AI 模型提供与 MySQL 数据库交互的接口。

概述

此软件包创建一个 MCP 服务，用于连接 MySQL 数据库并提供执行 SQL 查询的工具。它允许 Claude 等 AI 模型与 MySQL 数据库交互，而无需直接访问数据库。

前提条件

• Python 3.11 或更高版本
• MySQL 数据库

安装

你可以使用 pip 安装 MCP MySQL 服务：

pip install mcp_mysql_connect

也可以使用 UV：

uv pip install mcp_mysql_connect

配置

服务需要以下环境变量：

• DB_HOST - MySQL 服务主机
• DB_USER - MySQL 用户名
• DB_PASSWORD - MySQL 密码
• DB_NAME - MySQL 数据库名称

你可以通过 .env 文件或直接在环境中设置这些变量。

使用方式

1. 与 Cursor 配合使用

将以下内容添加到 ~/.cursor/mcp.json 配置中：

"mysql-mcp-server": {
  "command": "uvx",
  "args": [
    "--from",
    "mcp_mysql_connect",
    "mcp_mysql_connect"
  ],
  "env": {
    "DB_HOST": "your-mysql-host",
    "DB_USER": "your-username",
    "DB_PASSWORD": "your-password",
    "DB_NAME": "your-database"
  }
}

替代配置：

"mysql-mcp-server": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp_mysql_connect",
    "-m",
    "mcp_mysql_connect"
  ],
  "env": {
    "DB_HOST": "your-mysql-host",
    "DB_USER": "your-username",
    "DB_PASSWORD": "your-password",
    "DB_NAME": "your-database"
  }
}

2. 使用 Python 代码

from mcp.client import Client
from mcp.tools import Tools

# Connect to the MySQL MCP server
tools = Tools()
tools.add_server("mysql", "mcp_mysql_connect")

# Create a client with the tools
client = Client(tools=tools)

# Example query
response = client.complete(
    messages=[
        {"role": "user", "content": "Query all users from the database"}
    ]
)
print(response.content)

3. 手动运行

手动启动服务：

# Set environment variables first
export DB_HOST=your-mysql-host
export DB_USER=your-username
export DB_PASSWORD=your-password
export DB_NAME=your-database

# Then run the server
python -m mcp_mysql_connect

可用工具

此服务提供 SQL 执行工具，可用于查询 MySQL 数据库：

• read_query(query: str, params: List[str] = None) - 对数据库执行 SQL SELECT 查询

查询示例

与 Claude 或其他 AI 模型配合使用时，你可以用自然语言提问，例如：

• “显示上周注册的所有用户”
• “销量最高的 5 种产品是什么？”
• “统计每位客户下过多少订单”

AI 模型会将这些问题转换为 SQL 查询，并使用 MCP 服务执行查询。

许可证

MIT 许可证

参与贡献

欢迎贡献！欢迎提交 Pull Request。