🚀 MySQL MCP 服务器

本项目是一个集成 MySQL 数据库的 MCP 服务器实现，能为大语言模型（LLM）提供安全的数据库访问能力，保障数据交互的安全性与高效性。

🚀 快速开始

本 MySQL MCP 服务器可与 Dive Desktop 配合使用，为大语言模型提供数据库访问服务。以下是快速使用步骤：

1. 在 Dive Desktop 中点击 "+ 添加 MCP 服务器"。
2. 复制并粘贴以下配置：

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mysql-mcp"
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

3. 点击"保存"以安装 MCP 服务器。

若需要，也可以手动启动服务器：

npx @kevinwatt/mysql-mcp

✨ 主要特性

读取操作

• 执行只读 SELECT 查询。
• 列出所有数据库表。
• 查看表结构。
• 显示模式信息。

写入操作

• 执行 INSERT/UPDATE/DELETE 操作，带有事务支持。
• 使用参数化查询确保数据安全。
• 返回受影响行数和插入 ID。

安全性

• SELECT 查询的只读事务模式。
• 查询长度和结果集大小限制。
• 性能监控和日志记录。
• 自动事务处理。

📦 安装指南

使用以下命令全局安装：

npm install -g @kevinwatt/mysql-mcp

💻 使用示例

基础用法

让您的大语言模型执行以下指令：

"显示数据库中所有表格"
"描述 users 表的结构"
"查询所有活跃用户"
"向 orders 表插入一条新记录"

📚 详细文档

工具文档

mysql_query

• 功能：执行只读 SELECT 查询。
• 输入：
  • sql (字符串)：要执行的 SELECT SQL 查询。
• 限制：
  • 最大查询长度：4096 字符。
  • 最大结果行数：1000。
  • 查询超时时间：30 秒。

mysql_execute

• 功能：执行数据修改操作。
• 输入：
  • sql (字符串)：SQL 语句（INSERT/UPDATE/DELETE）。
  • params (数组，可选)：SQL 语句的参数。
• 功能：
  • 返回受影响行数。
  • 返回最后插入 ID。
  • 自动事务处理。

list_tables

• 功能：列出当前数据库中的所有表。
• 输入：无。

describe_table

• 功能：显示表结构。
• 输入：
  • table (字符串)：要描述的表名。

🔧 技术细节

要求

• Node.js 18+ 版本。
• MySQL 服务。
• 兼容 MCP 的 LLM 服务。

📄 许可证

本项目采用 MIT 许可证。

👨‍💻 作者

Dewei Yen

🔑 关键字

• mcp
• mysql
• 数据库
• dive
• llm
• ai