ArangoDB 用 MCP サーバー
ArangoDB 用のモデルコンテキストプロトコルサーバー
これはTypeScriptベースのMCPサーバーで、ArangoDBを介してデータベースとの連携機能を提供します。コアとなるデータベース操作を実装し、MCPツールを介してArangoDBとのシームレスな統合を可能にします。Claudeアプリや、ClineなどのMCPと連携するVSCode拡張機能でも使用できます。
特徴
ツール
arango_query- AQLクエリを実行する必須パラメータとしてAQLクエリ文字列を受け取ります
オプションでパラメータ化されたクエリのバインド変数を受け入れる
クエリ結果をJSONとして返します
arango_insert- コレクションにドキュメントを挿入するコレクション名とドキュメントオブジェクトを必須パラメータとして受け取ります
提供されていない場合はドキュメントキーを自動的に生成します
作成されたドキュメントのメタデータを返します
arango_update- 既存のドキュメントを更新するコレクション名、ドキュメントキー、更新オブジェクトを必須パラメータとして受け取ります
更新されたドキュメントのメタデータを返します
arango_remove- コレクションからドキュメントを削除するコレクション名とドキュメントキーを必須パラメータとして受け取ります
削除されたドキュメントのメタデータを返します
arango_backup- すべてのコレクションをJSONファイルにバックアップします出力ディレクトリのパスを必須パラメータとして受け取ります
現在のデータを含む各コレクションのJSONファイルを作成します
データのバックアップや移行に役立ちます
arango_list_collections- データベース内のすべてのコレクションを一覧表示する名前、ID、タイプを含むコレクション情報の配列を返します
arango_create_collection- データベースに新しいコレクションを作成するコレクション名を必須パラメータとして受け取ります
オプションでコレクションタイプ（ドキュメントまたはエッジコレクション）を指定します
書き込み操作の waitForSync 動作を構成する
名前、タイプ、ステータスなどのコレクション情報を返します
Related MCP server: MongoDB MCP Server
インストール
NPM経由でインストール
NPM 経由でarango-serverをグローバルにインストールするには、次のコマンドを実行します。
NPX経由で実行
インストールせずにarango-serverを直接実行するには、次のコマンドを使用します。
VSCodeエージェントの設定
VSCode Copilot エージェントでarango-serverを使用するには、少なくともVSCode 1.99.0 がインストールされており、次の手順に従う必要があります。
MCP 構成ファイルを作成または編集します。
次の構成を追加します。
{ "servers": { "arango-mcp": { "type": "stdio", "command": "npx", "args": ["arango-server"], "env": { "ARANGO_URL": "http://localhost:8529", "ARANGO_DB": "v20", "ARANGO_USERNAME": "app", "ARANGO_PASSWORD": "75Sab@MYa3Dj8Fc" } } } }MCP サーバーを起動します。
VSCode でコマンド パレットを開きます (Mac の場合は
Ctrl+Shift+P、Cmd+Shift+P)。コマンド
MCP: Start Serverを実行し、リストからarango-mcpを選択します。
サーバーを検証します:
VSCode でチャット ビューを開き、エージェント モードに切り替えます。
Toolsボタンを使用してarango-serverツールが利用可能であることを確認します。
Smithery経由でインストール
Smithery経由で Claude Desktop 用の ArangoDB を自動的にインストールするには:
Claude Desktopで使用するには
Settings > Developer > Edit Configまたは
MacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.json
Cline VSCode拡張機能を使用するには
Cline Extension > MCP Servers > Edit Configurationまたは
MacOS:
~/Library/Application Support/Code/User/globalStorage/cline.cline/config.jsonWindows:
%APPDATA%/Code/User/globalStorage/cline.cline/config.json
mcpServersセクションに次の構成を追加します。
環境変数
サーバーには次の環境変数が必要です。
ARANGO_URL- ArangoDB サーバーの URL (注: 8529 はローカル開発用の ArangoDB のデフォルト ポートです)ARANGO_DB- データベース名ARANGO_USERNAME- データベースユーザーARANGO_PASSWORD- データベースパスワード
使用法
意味のあるプロンプトであれば何でも提供でき、Claude は適切な機能を実行しようとします。
いくつかの例のプロンプト:
「データベース内のすべてのコレクションを一覧表示する」
「すべてのユーザーを照会する」
「「John Doe」という名前の新しいドキュメントを挿入し、「 john@example.com 」を「users」コレクションにメールで送信します」
「キー「123456」または名前「Jane Doe」でドキュメントを更新して、年齢を48歳に変更します」
「「products」という名前の新しいコレクションを作成します」
Claudeアプリでの使用
Cline VSCode拡張機能を使用する
すべてのユーザーを照会:
新しいドキュメントを挿入します:
ドキュメントを更新します。
ドキュメントを削除します。
すべてのコレクションを一覧表示します:
バックアップ データベース コレクション:
新しいコレクションを作成します。
注: サーバーはデータベース構造に依存せず、ArangoDB のドキュメントおよびエッジ コレクション モデルに従っている限り、任意のコレクション名または構造で動作します。
免責事項
開発目的のみ
このツールはローカル開発環境専用です。技術的には本番データベースへの接続も可能ですが、重大なセキュリティリスクが生じるため、推奨されません。本番環境データの保護と懸念事項の分離を維持するため、本ツールは開発データベースでのみ使用しています。
発達
リポジトリをクローンする
依存関係をインストールします:
npm run build自動リビルドを使用した開発の場合:
npm run watch
デバッグ
MCP サーバーは stdio 経由で通信するため、デバッグが困難になる場合があります。開発にはMCP Inspectorを使用してデバッグを行うことをお勧めします。
インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。