Mysql Explorer

🚀 基于 NodeJS 的 MySQL MCP 服务器

这是一个基于 NodeJS 的服务器，它遵循 Model Context Protocol，可提供对 MySQL 数据库的只读访问。借助该服务器，LLM 能够查看数据库架构并执行只读查询，为数据交互提供便利。

🚀 快速开始

要将此服务器与 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 替换为您的数据库名称，或留空以检索所有数据库。

✨ 主要特性

工具

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

资源

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

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

💻 使用示例

基础用法

在 claude_desktop_config.json 中配置服务器信息：

{
  "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"
      }

    }
  }
}

高级用法

如果您遇到错误“无法连接到 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 文件。