SQL MCP Server for Claude Desktop

SQL MCP Server for Claude Desktop

site icon
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连接凭证

常见问题解答

  1. 连接被拒绝:确保MySQL服务器正在运行
  2. 认证错误:验证.env文件中的凭证
  3. 权限错误:确保MySQL用户具有适当的权限

使用教程

使用依赖

  • Python 3.8或更高版本
  • MySQL服务器已安装并运行
  • Claude Desktop应用程序
  • 虚拟环境(推荐)

安装教程

  1. 克隆仓库:
git clone [email protected]:meanands/mysql-mcp.git
cd mysql-mcp
  1. 创建并激活虚拟环境:
# macOS/Linux
python -m venv venv
source venv/bin/activate

# Windows
python -m venv venv
venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt
  1. 创建.env文件:
MYSQL_HOST=localhost
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
  1. 更新run.sh中的目录路径
  2. 使run.sh可执行:
chmod +x run.sh

调试方式

  1. 确保MySQL服务器正在运行
  2. 验证.env文件中的凭证
  3. 检查run.sh中的路径是否正确
  4. 检查Claude Desktop的MCP配置是否正确

许可证

None