MCP MySQL 应用程序

模型上下文协议 (MCP) 工具服务器实现，用于通过 AI 接口与 MySQL 数据库交互。

概述

该项目提供了一套工具，允许 AI 系统通过模型上下文协议 (MCP) 连接并查询 MySQL 数据库。它使 AI 助手能够执行 SQL 查询并检查数据库连接性。

Related MCP server: MCP MySQL Server

特征

简单但功能强大的 MySQL 工具集成
类型安全的工具定义
增强错误处理
支持处理请求中止信号
会话感知

安装

克隆此存储库
安装依赖项：

npm install

如何使用该工具

1.初始设置

克隆此存储库：

git clone <repository-url> 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 配置文件：

Windows： C:\Users\<username>\.cursor\mcp.json
macOS： ~/.cursor/mcp.json
Linux： ~/.cursor/mcp.json

编辑文件以添加 MySQL MCP 服务器配置：

{ "mcpServers": { "mysql": { "command": "<path-to-node>", "args": [ "<path-to-project>/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" } } } }

替换占位符：

<path-to-node> ：Node.js 可执行文件的路径
<path-to-project> ：MCP MySQL App 项目目录的绝对路径
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": "<path-to-node>", "args": [ "<path-to-project>/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" } } } }

替换占位符：

<path-to-node> ：Node.js 可执行文件的路径
<path-to-project> ：MCP MySQL App 项目目录的绝对路径
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 的配置区域
使用此存储库中的dist/index.js文件将其配置为运行 Node.js
在环境配置中包含 MySQL 连接详细信息

可用工具

配置完成后，您的 AI 将可以访问以下 MySQL 工具：

sql_check_connection - 检查 MySQL 连接是否正常工作
sql_query - 在连接的数据库上执行 SQL 查询

在 AI 环境中使用 MySQL 工具

在 AI 环境中配置好 MySQL 工具后，您可以通过提示 AI 来开始使用它们。以下是一些示例：

在 Cursor 中使用 MySQL 工具

在 Cursor 中，你可以简单地要求 Claude 执行与 MySQL 相关的任务：

检查 MySQL 连接是否正常。
显示服务器上的所有数据库。
从当前数据库中获取所有表。
执行查询以从用户表中检索所有用户。
更新产品表中的记录。

示例工作流程：查询和操作数据

以下是一个示例工作流程，展示了如何使用这些工具：

检查连接：
“检查 MySQL 连接是否正常工作。”
Claude 将使用sql_check_connection工具来验证数据库连接。
查看数据库：
“显示此 MySQL 服务器上的所有数据库。”
Claude 将使用带有SHOW DATABASES;的sql_query工具。
探索表格：
“列出当前数据库中的所有表。”
Claude 将使用带有SHOW TABLES;的sql_query工具。
查询数据：
“显示用户表中的前 10 条记录。”
Claude 将使用带有SELECT * FROM users LIMIT 10;``sql_query工具。
创建表：
“创建一个名为‘产品’的新表，其中包含 id、名称、价格和描述等列。”
Claude 将使用sql_query工具通过适当的 CREATE TABLE 语句创建表。
插入数据：
“插入一个新产品，名称为‘智能手机’，价格为 499.99，描述为‘最新型号’。”
Claude 将使用带有 INSERT 语句的sql_query工具。
更新记录：
“将‘智能手机’产品的价格更新为 449.99。”
Claude 将使用带有 UPDATE 语句的sql_query工具。