基于 NodeJS 的 MySQL MCP 服务器

这是一个提供只读访问 MySQL 数据库的 Model Context Protocol 服务器。此服务器使 LLM 能够查看数据库架构并执行只读查询。

组件

工具

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

资源

该服务器提供每个表的架构信息：

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

使用 Claude Desktop 的配置

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

{
  "mcpServers": {
    "mcp_server_mysql": {
      "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_mysql": {
      "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 许可证发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参阅项目存储库中的 LICENSE 文件。