MCP MySQL应用程序
模型上下文协议（MCP）工具服务器实现，用于通过AI接口与MySQL数据库交互。
概述
该项目提供了一套工具，允许人工智能系统通过模型上下文协议连接和查询MySQL数据库。它使AI助手能够执行SQL查询并检查数据库连接。
特性
- 简单但强大的MySQL工具集成
- 类型安全工具定义
- 增强的错误处理
- 支持处理请求中止信号
- 会话意识
安装
- 克隆此存储库
- 安装依赖项：
npm install如何使用该工具
1.初始设置
克隆此存储库：
git clone
cd mcp-mysql-app安装依赖项：
npm install创建一个 .env 根目录中的文件：
MYSQL_HOST=your_mysql_host
MYSQL_USER=your_mysql_username
MYSQL_PASSWORD=your_mysql_password
MYSQL_DATABASE=your_database_name
MYSQL_PORT=3306构建项目：
npm run build这 dist 文件夹现在已准备好用于各种AI平台中的配置。
2.光标配置
查找您的Cursor MCP配置文件：
- 窗户：
C:\Users\\.cursor\mcp.json - macOS：
~/.cursor/mcp.json - Linux：
~/.cursor/mcp.json
编辑文件以添加MySQL MCP服务器配置：
{
"mcpServers": {
"mysql": {
"command": "
",
"args": [
"
/dist/index.js"
],
"env": {
"MYSQL_HOST": "your_mysql_host",
"MYSQL_USER": "your_mysql_username",
"MYSQL_PASSWORD": "your_mysql_password",
"MYSQL_DATABASE": "your_database_name",
"MYSQL_PORT": "3306"
}
}
}
}替换占位符：
- `
`：Node.js可执行文件的路径
- `
`：MCP MySQL应用程序项目目录的绝对路径
- MySQL环境变量与您的实际数据库连接详细信息
配置示例：
{
"mcpServers": {
"mysql": {
"command": "C:\\nvm4w\\nodejs\\node.exe",
"args": [
"H:\\mcp\\my-mysql\\dist\\index.js"
],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "password123",
"MYSQL_DATABASE": "todo_app",
"MYSQL_PORT": "3306"
}
}
}
}保存文件并重新启动Cursor以使更改生效。
3.克劳德配置
要将MCP MySQL Tools与Claude一起使用，您需要将配置添加到Claude的设置文件中。请按照以下步骤操作：
- 打开Claude AI桌面应用程序设置
- 导航到“开发人员”部分
- 查找“工具”配置部分
- 添加MySQL MCP的配置如下：
{
"tools": {
"mysql": {
"command": "
",
"args": [
"
/dist/index.js"
],
"env": {
"MYSQL_HOST": "your_mysql_host",
"MYSQL_USER": "your_mysql_username",
"MYSQL_PASSWORD": "your_mysql_password",
"MYSQL_DATABASE": "your_database_name",
"MYSQL_PORT": "3306"
}
}
}
}替换占位符：
- `
`：Node.js可执行文件的路径
- `
`：MCP MySQL应用程序项目目录的绝对路径
- MySQL环境变量与您的实际数据库连接详细信息
配置示例：
{
"tools": {
"mysql": {
"command": "/usr/local/bin/node",
"args": [
"/Users/username/projects/mcp-mysql-app/dist/index.js"
],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "password123",
"MYSQL_DATABASE": "todo_app",
"MYSQL_PORT": "3306"
}
}
}
}4.其他平台上的配置
基本原理与支持MCP的其他AI平台相同：
- 查找外部工具或MCP的配置区域
- 配置它以运行Node.js
dist/index.js此存储库中的文件 - 在环境配置中包含MySQL连接详细信息
可用工具
配置后，您的AI将可以访问以下MySQL工具：
sql_check_connection-检查MySQL连接是否正常工作sql_query-在连接的数据库上执行SQL查询
在AI环境中使用MySQL工具
在AI环境中配置MySQL工具后，您可以通过提示AI来开始使用它们。以下是一些示例：
在游标中使用MySQL工具
在Cursor中，你可以简单地让Claude执行MySQL相关的任务：
- 检查MySQL连接是否正常。
- 显示服务器上的所有数据库。
- 从当前数据库中获取所有表。
- 执行查询以从用户表中检索所有用户。
- 更新产品表中的记录。
示例工作流：查询和操作数据
以下是一个示例工作流，显示了如何使用这些工具：
- 检查连接：
“检查MySQL连接是否正常。”
克劳德将使用 sql_check_connection 用于验证数据库连接的工具。
- 查看数据库：
“显示此MySQL服务器上的所有数据库。”
克劳德将使用 sql_query 工具与 SHOW DATABASES;.
- 探索表格：
“列出当前数据库中的所有表。”
克劳德将使用 sql_query 工具与 SHOW TABLES;.
- 查询数据：
“显示用户表中的前10条记录。”
克劳德将使用 sql_query 工具与 SELECT * FROM users LIMIT 10;.
- 创建表：
创建一个名为“products”的新表，其中包含id、名称、价格和描述列
克劳德将使用 sql_query 工具，使用适当的create table语句创建表。
- 插入数据：
插入一款名为“智能手机”、价格为499.99、描述为“最新型号”的新产品
克劳德将使用 sql_query 带有INSERT语句的工具。
- 更新记录：
“将‘智能手机’产品的价格更新为449.99。”
克劳德将使用 sql_query 带有UPDATE语句的工具。
这些示例展示了一旦工具配置正确，您可以通过AI助手自然地与MySQL交互。
支持和帮助
如果您在使用此工具时遇到问题，请：
- 检查MySQL连接详细信息是否正确
- 确保Node.js安装正确
- 检查AI平台中的MCP配置
- 检查日志文件中可能出现的任何错误消息
- 验证MySQL服务器的网络连接
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。