AI导哈

MySQL自然语言查询服务

一个通过自然语言查询与MySQL数据库交互的MCP服务器，为AI模型提供数据库访问接口。

  • by gopikapeenikkal
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gopikapeenikkal/mysql-mcp-server

使用说明

MySQL MCP服务器

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

概述

此包创建了一个连接到MySQL数据库的MCP服务器，并公开了一个执行SQL查询的工具。它允许像Claude这样的AI模型与MySQL数据库交互，而无需直接访问数据库。

先决条件

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

安装

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

pip install mcp_mysql_connect

或使用紫外线：

uv pip install mcp_mysql_connect

配置

服务器需要以下环境变量：

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

您可以使用 .env 文件或直接在您的环境中。

使用选项

1.使用光标

将以下内容添加到您的 ~/.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模型将这些转换为SQL查询，并使用MCP服务器来执行它们。

许可证

MIT许可证

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP