
SQL MCP Server for Claude Desktop

2025.03.11
2
Python数据库管理自然语言接口数据库
mysql-mcp是一个通过Claude Desktop提供自然语言接口的MySQL数据库交互工具。它允许用户使用自然语言与本地MySQL数据库进行交互,执行SQL查询,管理数据库事务等。
View on GitHub
Overview
基本能力
产品定位
mysql-mcp是一个自然语言到SQL查询的转换工具,专为Claude Desktop设计,用于与本地MySQL数据库进行交互。
核心功能
- 自然语言到SQL查询的转换
- 安全连接到本地MySQL数据库
- 支持多个数据库
- 事务管理保证数据一致性
- 连接池提高性能
- 支持所有类型的SQL查询(SELECT, INSERT, UPDATE, DELETE等)
适用场景
- 通过自然语言查询数据库
- 数据库管理和维护
- 数据分析和报告生成
- 数据库开发和测试
工具列表
run.sh
: 启动脚本,用于运行MCP服务器.env
: 配置文件,存储MySQL连接凭证
常见问题解答
- 连接被拒绝:确保MySQL服务器正在运行
- 认证错误:验证.env文件中的凭证
- 权限错误:确保MySQL用户具有适当的权限
使用教程
使用依赖
- Python 3.8或更高版本
- MySQL服务器已安装并运行
- Claude Desktop应用程序
- 虚拟环境(推荐)
安装教程
- 克隆仓库:
git clone [email protected]:meanands/mysql-mcp.git
cd mysql-mcp
- 创建并激活虚拟环境:
# macOS/Linux
python -m venv venv
source venv/bin/activate
# Windows
python -m venv venv
venv\Scripts\activate
- 安装依赖:
pip install -r requirements.txt
- 创建.env文件:
MYSQL_HOST=localhost
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
- 更新run.sh中的目录路径
- 使run.sh可执行:
chmod +x run.sh
调试方式
- 确保MySQL服务器正在运行
- 验证.env文件中的凭证
- 检查run.sh中的路径是否正确
- 检查Claude Desktop的MCP配置是否正确
许可证
None