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 ファイルを参照してください。