基于 NodeJS 的 MySQL MCP 服务器

一个提供 MySQL 数据库只读访问的模型上下文协议 (Model Context Protocol, MCP) 服务器。此服务器允许大语言模型 (LLMs) 查看数据库模式并执行只读查询。

组件

工具

• mysql_query
  • 执行针对连接到的数据库的只读 SQL 查询
  • 输入：sql（字符串）：要执行的 SQL 查询
  • 所有查询都在 READ ONLY 事务中执行

资源

服务器提供每个表的模式信息：

• 表结构
  • 每个表的 JSON 模式信息
  • 包括列名和数据类型
  • 自动从数据库元数据中发现

使用 Claude Desktop 的配置

要在 Claude Desktop 应用中使用此服务器，请将以下配置添加到 claude_desktop_config.json 文件中的 "mcpServers" 部分：

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

将 db_name 替换为您的数据库名称，或留空以检索所有数据库。

故障排除

如果您遇到错误“无法连接到 MCP 服务器 mcp-server-mysql”，您可能需要显式地设置所有必需二进制文件的路径，例如以下配置：

{
  "mcpServers": {
    "mcp_server_myqsl": {
      "command": "/path/to/npx/binary/npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name",
        "PATH": "/path/to/node/bin:/usr/bin:/bin" // 添加此行
      }
    }
  }
}

许可证

该 MCP 服务器根据 MIT License 分发。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的 LICENSE 文件。