MySQL MCP Server for Smithery (Python)

适用于 Smithery 的 MySQL MCP 服务（Python）

适用于 Smithery 的 MySQL 连接器，使用 Python 构建，可让你直接从 Smithery 连接到 MySQL 数据库。

功能

• 连接到 MySQL 数据库：配置并连接 MySQL 数据库
• 列出数据库：查看所有可访问的数据库
• 列出表：查看指定数据库中的所有表
• 描述表：获取表的详细架构信息
• 执行查询：运行只读 SQL 查询（SELECT、SHOW、DESCRIBE、EXPLAIN）
• 安全性：内置查询验证，确保只允许只读操作

在 Smithery 中安装

在 Smithery 中添加 MCP 服务后，你可以输入 MySQL 数据库凭据：

• Host：数据库服务器主机名（默认值：localhost）
• Port：数据库服务器端口（默认值：3306）
• User：你的 MySQL 用户名
• Password：你的 MySQL 密码
• Database：（可选）要连接的特定数据库

手动安装

1. 克隆此仓库：

git clone https://github.com/aqaralife/mysql-mcp-python-server.git

2. 安装依赖项：

cd mysql-mcp-python-server
npm install
pip install -r requirements.txt

3. 使脚本可执行（Unix/Linux/Mac）：

chmod +x mcp_server.py run.js

手动使用

启动服务：

node run.js

或者，直接运行 Python 脚本：

python mcp_server.py

可用工具

connect_db

建立与 MySQL 数据库的连接。

参数：

• host：数据库服务器主机名
• port：数据库服务器端口
• user：数据库用户名
• password：数据库密码
• database：（可选）数据库名称

list_databases

列出所有可访问的数据库。

参数： 无

list_tables

列出数据库中的所有表。

参数：

• database：（可选）数据库名称；如果已连接，则使用默认数据库

describe_table

显示表的架构。

参数：

• table：表名
• database：（可选）数据库名称；如果已连接，则使用默认数据库

execute_query

执行只读 SQL 查询。

参数：

• query：SQL 查询（仅允许 SELECT、SHOW、DESCRIBE 和 EXPLAIN）
• database：（可选）数据库名称；如果已连接，则使用默认数据库

安全性

此服务包含内置验证，确保只允许只读操作：

• 仅允许 SELECT、SHOW、DESCRIBE 和 EXPLAIN 查询
• 自动拒绝包含 INSERT、UPDATE、DELETE、DROP 等 SQL 命令的查询
• 不允许在单个查询中执行多个语句（以分号分隔）

故障排除

如果遇到问题：

1. 找不到 Python：服务会自动检测 python3 或 python。如果两者都无法使用，请确保已安装 Python 并将其添加到 PATH 中。

2. 缺少模块：服务会尝试自动安装所需的软件包。如果安装失败，请手动运行：

   pip install mysql-connector-python>=8.0.0
   

3. 连接问题：请检查数据库凭据，并确保 MySQL 服务器正在运行且可访问。

4. Smithery 连接问题：请确保 Smithery 中的设置已使用你的数据库凭据正确配置。

5. 服务无响应：请检查 Smithery 控制台中的日志输出，查看是否有错误。

许可证

MIT

联系方式

如有任何问题，请创建一个 issue。