MySQL MCP Server

MySQL MCP 服务

一个功能强大的 MCP 服务，可直接访问 MySQL 数据库。此服务使 AI Agent 能够通过简单的界面与 MySQL 数据库交互、执行 SQL 查询并管理数据库内容。

功能

资源

• 通过 note:///{id} URI 访问存储在数据库中的笔记
• 每条笔记都包含标题和内容
• 使用纯文本 MIME 类型，便于访问内容

工具

• create_note - 在数据库中创建新的文本笔记
  • 将标题和内容作为必需参数
  • 将笔记存储在 MySQL 数据库中
• list_tables - 列出已连接数据库中的所有表
• count_tables - 获取数据库中的表总数
• search_tables - 使用 LIKE 模式搜索表
• describe_table - 获取指定表的结构
• execute_sql - 执行自定义 SQL 查询

先决条件

• Node.js 18 或更高版本
• 已安装并运行的 MySQL 服务
• 具有适当权限的数据库

设置

1. 克隆此仓库：

   git clone [email protected]:LeonMelamud/mysql-mcp.git
   cd mysql-mcp
   

2. 安装依赖项：

   npm install
   

3. 在根目录中创建 .env 文件，并填入 MySQL 连接详情：

   MYSQL_HOST=localhost
   MYSQL_USER=your_username
   MYSQL_PASSWORD=your_password
   MYSQL_DATABASE=your_database
   

4. 构建服务：

   npm run build
   

安装

用于 Claude Desktop

将服务配置添加到 Claude Desktop 配置文件中：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

用于 Cline

将服务配置添加到 Cline MCP 设置文件中：

MacOS：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json Windows：%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用示例

安装后，你可以在与 Claude 的对话中使用 MySQL MCP 服务：

列出数据库中的所有表

Please list all the tables in my MySQL database.

执行 SQL 查询

Run this SQL query: SELECT * FROM users LIMIT 5

创建笔记

Create a note titled "Meeting Notes" with the content "Discussed project timeline and assigned tasks."

开发

启用自动重新构建进行开发：

npm run watch

调试

使用 MCP Inspector 调试服务：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

许可证

MIT