Ravenwits MCP Server Arangodb

🚀 ArangoDB 的 MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，藉助 MCP 工具實現了與 ArangoDB 數據庫的交互。它不僅實現了核心數據庫操作，還支持與 ArangoDB 的無縫集成。該服務器可用於 Claude 應用，也適用於與 Cline 配合使用的 VSCode 擴展！

✨ 主要特性

工具

• arango_query - 執行 AQL 查詢

  • 需傳入 AQL 查詢字符串作為必填參數。
  • 可選擇傳入綁定變量，以支持參數化查詢。
  • 查詢結果以 JSON 格式返回。

• arango_insert - 向集合中插入文檔

  • 需傳入集合名稱和文檔對象作為必填參數。
  • 若未提供文檔鍵，系統將自動生成。
  • 返回創建的文檔元數據。

• arango_update - 更新現有文檔

  • 需傳入集合名稱、文檔鍵和更新對象作為必填參數。
  • 返回更新後的文檔元數據。

• arango_remove - 從集合中刪除文檔

  • 需傳入集合名稱和文檔鍵作為必填參數。
  • 返回被刪除的文檔元數據。

• arango_backup - 備份所有集合到 JSON 文件

  • 需傳入輸出目錄路徑作為必填參數。
  • 為每個集合創建 JSON 文件，並保存當前數據。
  • 適用於數據備份和遷移。

• arango_list_collections - 列出數據庫中的所有集合

  • 返回包含名稱、ID 和類型的集合信息數組。

🔧 技術細節

該服務器不依賴於特定的數據庫結構，只要遵循 ArangoDB 文檔集和邊文檔模型即可工作。

📦 安裝指南

開發依賴安裝

npm run build

帶有自動重建功能的開發

npm run watch

與 Claude 桌面應用配合使用

在 mcpServers 部分添加服務器配置：

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

與 Cline VSCode 擴展配合使用

在 mcpServers 部分添加以下配置：

• MacOS: ~/Library/Application Support/Code/User/globalStorage/cline.cline/config.json
• Windows: %APPDATA%/Code/User/globalStorage/cline.cline/config.json

{
  "servers": {
    "arangoMCP Server": {
      "executablePath": "/path/to/arango_mcp_server",
      "schemaVersion": "0.9.3"
    }
  }
}

🚀 快速開始

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們建議使用 MCP Inspector 進行開發：

npm run inspector

Inspector 將提供一個 URL，以便您在瀏覽器中訪問調試工具。

📄 許可證

該項目根據 MIT 許可證發佈 - 有關詳細信息，請參閱 LICENSE 文件。