MySQL MCP Server for Smithery (Python)

基本能力

产品定位

MySQL MCP Server for Smithery (Python) 是一个用于连接和操作MySQL数据库的工具，特别适合需要在Smithery环境中进行数据库查询和管理的场景。

核心功能

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

适用场景

• 在Smithery环境中进行MySQL数据库查询和管理。
• 需要快速查看数据库结构和表信息的场景。
• 执行只读SQL查询的场景。

工具列表

• connect_db：建立与MySQL数据库的连接。
• list_databases：列出所有可访问的数据库。
• list_tables：列出指定数据库中的所有表。
• describe_table：显示表的架构信息。
• execute_query：执行只读SQL查询。

常见问题解答

1. Python未找到：确保Python已安装并在PATH中。
2. 缺少模块：手动运行 pip install mysql-connector-python>=8.0.0。
3. 连接问题：验证数据库凭据并确保MySQL服务器正在运行且可访问。
4. Smithery连接问题：确保Smithery中的设置正确配置了数据库凭据。
5. 服务器无响应：检查Smithery控制台中的日志输出以查找错误。

使用教程

使用依赖

1. 确保已安装Python和npm。
2. 安装依赖：

pip install mysql-connector-python>=8.0.0
npm install

安装教程

1. 克隆仓库：

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

1. 进入目录并安装依赖：

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

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

chmod +x mcp_server.py run.js

调试方式

1. 启动服务器：

node run.js

或直接运行Python脚本：

python mcp_server.py

1. 检查日志输出以调试问题。

许可证

该项目遵循 MIT 开源许可条款。