SQL MCP Server for Claude Desktop

Claude 桌面版的 SQL MCP 服务器

通过 Claude Desktop 提供与本地 MySQL 数据库的自然语言接口。此 MCP（机器通信协议）服务器允许 Claude 在您的本地 MySQL 数据库上执行 SQL 查询，从而让您能够使用自然语言与数据库进行交互。

特征

• 通过 Claude 将自然语言转换为 SQL 查询
• 与本地 MySQL 数据库的安全连接
• 支持多种数据库
• 数据一致性的事务管理
• 连接池可实现更好的性能
• 支持所有类型的 SQL 查询（SELECT、INSERT、UPDATE、DELETE 等）

先决条件

• Python 3.8 或更高版本
• MySQL 服务器已安装并正在运行
• Claude桌面应用程序
• 虚拟环境（推荐）

安装

1. 克隆此存储库：

2. 创建并激活虚拟环境：

3. 安装依赖项：

4. 使用您的 MySQL 凭据在项目根目录中创建一个.env文件：

5. 更新run.sh中的目录路径：

6. 使运行脚本可执行：

Claude Desktop中的配置

1. 打开Claude Desktop的MCP配置
2. 添加以下配置：

将/absolute/path/to/your/mysql-mcp替换为项目目录的实际绝对路径。

用法

配置完成后，您可以通过 Claude Desktop 使用自然语言与数据库进行交互。示例：

1. 选择数据库并创建表：

2. 插入数据：

3. 查询数据：

重要提示

• 始终在 run.sh 脚本和 Claude Desktop 配置中使用绝对路径
• 使用 MCP 服务器前，请确保 MySQL 服务器正在运行
• 确保 .env 文件的安全，切勿将其提交到版本控制
• MCP 服务器使用连接池，默认池大小为 5 个连接

故障排除

1. 如果出现“连接被拒绝”错误，请确保 MySQL 服务器正在运行
2. 如果出现身份验证错误，请在 .env 文件中验证您的凭据
3. 对于权限错误，请确保您的 MySQL 用户对您尝试执行的操作具有适当的权限

安全注意事项

• 将敏感凭证存储在 .env 文件中
• 使用具有适当权限的 MySQL 用户（避免使用 root）
• 保持虚拟环境和依赖项保持最新
• 如果访问非本地主机的 MySQL 服务器，请考虑网络安全