基于 NodeJS 的 MySQL MCP 服务器

这是一个提供对 MySQL 数据库只读访问的模型上下文协议（MCP）服务器。该服务器使 LLMs 能够检查数据库模式并执行只读查询。

组件

工具

• 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" <-- Add this
      }

    }
  }
}

许可证

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