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 文件。