MCP Mysql App

🚀 MySQL MCP 工具服务器

这是一个借助 AI 接口与 MySQL 数据库进行交互的 Model Context Protocol (MCP) 工具服务器实现。它为 AI 系统提供了便捷的方式来连接和查询 MySQL 数据库，极大地提升了数据交互的效率。

🚀 快速开始

该项目提供了一组工具，允许 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 连接信息（主机、端口、用户和密码）。

高级用法

在 AI 环境中使用 MySQL 工具

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

• 使用游标中的 MySQL 工具：在游标中，您可以简单地提示 Claude 执行与 MySQL 相关的任务：
  • 检查连接是否正常工作："检查 MySQL 连接是否正常工作。"
  • 查看所有数据库："显示此 MySQL 服务器上的所有数据库。"
  • 查看表："列出当前数据库中的所有表。"
  • 查询数据："显示用户表的前 10 条记录。"
  • 创建表："创建一个名为 'products' 的新表，其中包含 id、名称、价格和描述列。"
  • 插入数据："插入一个新的产品，其名称为 '智能手机'，价格为 499.99，描述为 '最新型号'。"
  • 更新记录："将 '智能手机' 产品的价格更新为 449.99。"

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

📚 详细文档

可用工具

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

支持和帮助

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

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

📄 许可证

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