Mysqldb MCP Server

🚀 MySQL數據庫MCP服務器

本項目是一個MySQL數據庫MCP服務器，能夠為用戶提供便捷的數據庫連接與查詢服務。

🚀 快速開始

安裝

你可以使用以下兩種方式安裝該包：

• 使用uv：

uv pip install mysqldb-mcp-server

• 使用pip：

pip install mysqldb-mcp-server

配置服務器

服務器使用以下環境變量進行配置：

不同系統下的配置文件路徑

Claude Desktop

• MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

服務器配置示例

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/burakdirin/Projects/mysqldb-mcp-server",
        "run",
        "mysqldb-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "[optional]",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uvx",
      "args": [
        // 此處原文未完整展示，保持原樣
      ]
    }
  }
}

✨ 主要特性

工具

該服務器提供兩個實用工具：

• connect_database：用於連接到特定的MySQL數據庫。
  • database參數：要連接的數據庫名稱（字符串）
  • 連接成功時返回確認消息
• execute_query：執行MySQL查詢。
  • query參數：要執行的一個或多個SQL查詢（字符串）
  • 以JSON格式返回查詢結果
  • 多個查詢可以通過分號分隔發送

📦 安裝指南

你可以使用以下兩種方式安裝mysqldb-mcp-server包：

• 使用uv：

uv pip install mysqldb-mcp-server

• 使用pip：

pip install mysqldb-mcp-server

📚 詳細文檔

組件說明

工具

• connect_database：此工具用於連接到指定的MySQL數據庫。通過傳入database參數（字符串類型，表示要連接的數據庫名稱），在連接成功後會返回確認消息。
• execute_query：該工具用於執行MySQL查詢。通過傳入query參數（字符串類型，表示要執行的一個或多個SQL查詢），查詢結果將以JSON格式返回。多個查詢可以通過分號分隔發送。

配置說明

服務器依賴以下環境變量進行配置：

• MYSQL_HOST：指定MySQL服務器的地址，默認值為"localhost"。
• MYSQL_USER：指定MySQL用戶名，默認值為"root"。
• MYSQL_PASSWORD：指定MySQL密碼，默認值為空字符串。
• MYSQL_DATABASE：指定初始數據庫，該參數為可選。
• MYSQL_READONLY：用於啟用只讀模式，將其設為1或true可啟用，默認值為false。

快速開始說明

安裝

介紹了使用uv和pip兩種方式安裝mysqldb-mcp-server包的命令。

配置文件路徑

說明了在Claude Desktop的不同系統（MacOS和Windows）下的配置文件路徑。

服務器配置

提供了開發/未發佈和已發佈兩種情況下的服務器配置示例，包括命令、參數和環境變量的設置。

注意事項

請確保在使用服務器前正確配置環境變量，以保證服務器能夠正常連接到MySQL數據庫。同時，在執行execute_query工具時，要注意SQL查詢語句的正確性和安全性。

參考鏈接

通過該鏈接可以獲取更多關於該項目的信息。