MCP MySQL 应用程序

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

概述

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

特征

• 简单但功能强大的 MySQL 工具集成

• 类型安全的工具定义

• 增强错误处理

• 支持处理请求中止信号

• 会话感知

安装

1. 克隆此存储库

2. 安装依赖项：

如何使用该工具

1.初始设置

克隆此存储库：

安装依赖项：

在根目录中创建一个.env文件：

构建项目：

dist文件夹现在可以用于各种 AI 平台的配置了。

2. 游标配置

找到您的 Cursor MCP 配置文件：

• Windows： C:\Users\<username>\.cursor\mcp.json

• macOS： ~/.cursor/mcp.json

• Linux： ~/.cursor/mcp.json

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

替换占位符：

• <path-to-node> ：Node.js 可执行文件的路径

• <path-to-project> ：MCP MySQL App 项目目录的绝对路径

• MySQL 环境变量与实际数据库连接详细信息

示例配置：

保存文件并重新启动 Cursor 以使更改生效。

3.克劳德配置

要将 MCP MySQL Tools 与 Claude 结合使用，您需要在 Claude 的设置文件中添加配置。请按照以下步骤操作：

1. 打开 Claude AI 桌面应用程序设置

2. 导航至“开发者”部分

3. 查找“工具”配置部分

4. 添加 MySQL MCP 的配置如下：

替换占位符：

• <path-to-node> ：Node.js 可执行文件的路径

• <path-to-project> ：MCP MySQL App 项目目录的绝对路径

• MySQL 环境变量与实际数据库连接详细信息

示例配置：

4. 其他平台配置

其他支持MCP的AI平台基本原理相同：

1. 查找外部工具或 MCP 的配置区域

2. 使用此存储库中的dist/index.js文件将其配置为运行 Node.js

3. 在环境配置中包含 MySQL 连接详细信息

可用工具

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

• sql_check_connection - 检查 MySQL 连接是否正常工作

• sql_query - 在连接的数据库上执行 SQL 查询

在 AI 环境中使用 MySQL 工具

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

在 Cursor 中使用 MySQL 工具

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

• 检查 MySQL 连接是否正常。

• 显示服务器上的所有数据库。

• 从当前数据库中获取所有表。

• 执行查询以从用户表中检索所有用户。

• 更新产品表中的记录。

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

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

1. 检查连接：

   “检查 MySQL 连接是否正常工作。”

   Claude 将使用sql_check_connection工具来验证数据库连接。

2. 查看数据库：

   “显示此 MySQL 服务器上的所有数据库。”

   Claude 将使用带有SHOW DATABASES;的sql_query工具。

3. 探索表格：

   “列出当前数据库中的所有表。”

   Claude 将使用带有SHOW TABLES;的sql_query工具。

4. 查询数据：

   “显示用户表中的前 10 条记录。”

   Claude 将使用带有SELECT * FROM users LIMIT 10;``sql_query工具。

5. 创建表：

   “创建一个名为‘产品’的新表，其中包含 id、名称、价格和描述等列。”

   Claude 将使用sql_query工具通过适当的 CREATE TABLE 语句创建表。

6. 插入数据：

   “插入一个新产品，名称为‘智能手机’，价格为 499.99，描述为‘最新型号’。”

   Claude 将使用带有 INSERT 语句的sql_query工具。

7. 更新记录：

   “将‘智能手机’产品的价格更新为 449.99。”

   Claude 将使用带有 UPDATE 语句的sql_query工具。

这些示例展示了一旦工具配置正确，您就可以多么自然地通过 AI 助手与 MySQL 进行交互。

支持与帮助

如果您在使用此工具时遇到问题，请：

• 检查你的 MySQL 连接详细信息是否正确

• 确保 Node.js 已正确安装

• 检查您的 AI 平台中的 MCP 配置

• 检查日志文件中可能出现的任何错误消息

• 验证 MySQL 服务器的网络连接

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。