MySQL MCP服务器

一个实现模型上下文协议(MCP)的服务器,用于与MySQL数据库交互,允许通过MCP兼容客户端直接执行SQL查询。

  • by pleaodev
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 pleaodev/pedro-leao-mcp-mysql-server

使用说明

MySQL MCP服务器

该项目实现了一个模型上下文协议(MCP)服务器,用于与MySQL数据库交互。它允许直接通过MCP兼容的客户端(如Trae或Claude Desktop)执行SQL查询。

作者 Pedro Leão(高级全栈开发人员)

先决条件

安装

  1. 克隆或下载此存储库。
  2. 在项目文件夹中打开一个终端。
  3. 通过运行以下命令安装依赖项:
npm install

MCP配置

要在MCP客户端中使用此服务器,请将以下配置添加到MCP服务器配置文件中(例如。, claude_desktop_config.json 或Trae设置)。

你 必须 通过中的环境变量提供数据库凭据 env 块。

注: 确保调整路径 args 绝对路径的参数 index.js 此项目的文件位于您的系统上。

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": [
        "C:\\ABSOLUTE\\PATH\\TO\\pedro-leao-mcp-mysql-server\\index.js"
      ],
      "env": {
        "DB_HOST": "127.0.0.1",
        "DB_PORT": "3306",
        "DB_USER": "your_username",
        "DB_PASSWORD": "your_password",
        "DB_NAME": "your_database_name"
      }
    }
  }
}

环境变量

服务器使用以下环境变量进行连接:

变量 描述 默认值(如果未设置)
DB_HOST MySQL服务器地址 localhost
DB_PORT MySQL服务器端口 3306
DB_USER 数据库用户 root
DB_PASSWORD 用户密码 (无默认值)
DB_NAME 数据库名称 (无默认值)

特性

可用工具

  • 怎么翻译:对配置的数据库执行任何SQL查询。
    • 参数: sql (string)-要执行的SQL查询。

故障排除

  • 连接错误: 检查中的凭据是否 env 块是否正确,MySQL服务器是否正在运行且可访问。
  • 文件路径: 确保在中使用绝对路径 args 数组并使用双反斜杠(\\)如果你在Windows上。