返回市场
mysql-mcp

mysql-mcp

作者:LeonMelamud6 星标更新:2025-08-27

项目介绍

MySQL MCP 服务器

一个强大的 MCP 服务器,提供对 MySQL 数据库的直接访问。此服务器使 AI 代理能够通过简单接口与 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 git@github.com: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_m_设置.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 服务器:

列出数据库中的所有表

请列出我 MySQL 数据库中的所有表。

执行 SQL 查询

运行此 SQL 查询:SELECT * FROM users LIMIT 5

创建笔记

创建一个标题为“会议记录”的笔记,内容为“讨论了项目时间线并分配了任务。”

开发

用于开发时自动重建:

npm run watch

调试

使用 MCP Inspector 调试服务器:

npm run inspector

Inspector 将提供一个 URL,以便在浏览器中访问调试工具。

许可证

MIT </中文翻译>