MySQL MCP 工具服务器

这是一个通过 AI 接口与 MySQL 数据库交互的 Model Context Protocol (MCP) 工具服务器实现。

概述

该项目提供了一组工具，允许 AI 系统通过 Model Context Protocol 连接到并查询 MySQL 数据库。它使 AI 助手能够执行 SQL 查询并检查数据库连接状态。

特性

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

安装

1. 克隆此仓库
2. 安装依赖：

npm install

使用说明

游标配置

在游标中使用时，您需要在 settings.json 文件中进行以下设置：

{
  "mcpMySQL": {
    "host": "localhost",
    "port": 3306,
    "user": "root",
    "password": "password"
  }
}

其他 AI 平台配置

在其他 AI 平台中使用时，您需要根据平台的要求进行相应的配置。通常，您需要提供 MySQL 连接信息（主机、端口、用户和密码）。

可用工具

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

在 AI 环境中使用 MySQL 工具

一旦您配置好了 MySQL 工具，在您的 AI 环境中就可以开始使用它们。以下是示例：

使用游标中的 MySQL 工具

在游标中，您可以简单地提示 Claude 执行与 MySQL 相关的任务：

• 检查连接是否正常工作： "检查 MySQL 连接是否正常工作。"

• 查看所有数据库： "显示此 MySQL 服务器上的所有数据库。"

• 查看表： "列出当前数据库中的所有表。"

• 查询数据： "显示用户表的前 10 条记录。"

• 创建表： "创建一个名为 'products' 的新表，其中包含 id、名称、价格和描述列。"

• 插入数据： "插入一个新的产品，其名称为 '智能手机'，价格为 499.99，描述为 '最新型号'。"

• 更新记录： "将 '智能手机' 产品的价格更新为 449.99。"

这些示例展示了如何通过 AI 助手自然地与 MySQL 交互，一旦工具配置正确。

支持和帮助

如果您在使用此工具时遇到问题，请执行以下操作：

• 检查您的 MySQL 连接详细信息是否正确
• 确保 Node.js 已正确安装
• 检查您在 AI 平台中的 MCP 配置
• 查看日志文件中可能显示的任何错误消息
• 验证到 MySQL 服务器的网络连接

许可证

此项目 licensed under the MIT License，详细信息请参阅 LICENSE 文件。