MCP Server Mariadb Reader

🚀 MariaDB 讀者 MCP 服務器

本項目是一款用於探索和與 MariaDB 數據庫進行交互的 Model Context Protocol (MCP) 服務器。它為諸如 Cline 之類的 AI 助手提供了訪問 MariaDB 數據庫並檢索信息的工具，極大地提升了數據交互的便捷性。

🚀 快速開始

要使用此服務器，請克隆 GitHub 倉庫，並在 MCP 客戶端（例如 VS Code 擴展程序）的設置文件中註冊服務器信息。此存儲庫包含預構建的執行文件 (build/index.js)，因此無需進行額外的構建步驟。

✨ 主要特性

此 MCP 服務器提供以下功能：

• list_databases：返回所有可訪問的數據庫列表。
• list_tables：返回指定數據庫中的所有表的列表。
  • 輸入：database（字符串，必需）—— 要查詢表列表的數據庫名稱。
• get_table_schema：返回指定表的模式（列定義）。
  • 輸入：
    • database（字符串，必需）—— 表所屬的數據庫名稱。
    • table（字符串，必需）—— 要查詢模式的表名稱。
• query_table：從指定表中查詢數據。默認返回前 100 行。
  • 輸入：
    • database（字符串，必需）—— 表所屬的數據庫名稱。
    • table（字符串，必需）—— 要查詢數據的表名稱。
    • limit（數字，可選）—— 返回的最大行數（默認值：100）。

📦 安裝指南

克隆倉庫

git clone https://github.com/moosin76/mcp_server_mariadb_reader.git

修改 MCP 設置文件

設置示例：

{
  "mcpServers": {
    "mcp_server_mariadb_reader": {
      "command": "node",
      "args": ["<克隆倉庫的實際路徑>/build/index.js"], // 克隆倉庫中 build/index.js 文件的路徑
      "env": {
        "MARIADB_HOST": "YOUR_DB_HOST",         // MariaDB 服務器地址
        "MARIADB_PORT": "YOUR_DB_PORT",         // MariaDB 端口號（例如："3306"）
        "MARIADB_USER": "YOUR_DB_USER",         // MariaDB 用戶名
        "MARIADB_PASSWORD": "YOUR_DB_PASSWORD", // MariaDB 密碼
        "MARIADB_DATABASE": "YOUR_DEFAULT_DB"   // （可選）默認數據庫名稱
      },
      "disabled": false,
      "autoApprove": []
    }
    // 其他 MCP 服務器設置...
  }
}

注意：

• 將 <克隆倉庫的實際路徑> 替換為實際克隆的本地路徑。（例如：C:/Users/YourUser/Documents/GitHub/mcp_server_mariadb_reader）
• 修改 env 對象中的佔位符，如 YOUR_DB_HOST 等。

🔧 技術細節

開發步驟

若要進行源代碼修改，請執行以下步驟：

1. 安裝依賴項：

npm install

2. 構建項目：

npm run build

3. 使用即時監控（可選）：

npm run watch

📄 許可證

此項目在 [許可證信息待補充] 下分發。