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をグローバルにインストールするには、次のコマンドを実行します。

npm install -g arango-server

NPX経由で実行

インストールせずにarango-serverを直接実行するには、次のコマンドを使用します。

npx arango-server

VSCodeエージェントの設定

VSCode Copilot エージェントでarango-serverを使用するには、少なくともVSCode 1.99.0 がインストールされており、次の手順に従う必要があります。

MCP 構成ファイルを作成または編集します。
- ワークスペース固有の構成: ワークスペースで.vscode/mcp.jsonファイルを作成または編集します。
- ユーザー固有の構成: オプションで、設定 (mcp) VS Codeユーザー設定でサーバーを指定して、すべてのワークスペースで MCP サーバーを有効にします。
  ヒント: 構成ファイルの設定方法の詳細については、VSCode の 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 を自動的にインストールするには:

npx -y @smithery/cli install @ravenwits/mcp-server-arangodb --client claude

Claude Desktopで使用するには

Settings > Developer > Edit Configまたは

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

Cline VSCode拡張機能を使用するには

Cline Extension > MCP Servers > Edit Configurationまたは

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

mcpServersセクションに次の構成を追加します。

{
	"mcpServers": {
		"arango": {
			"command": "node",
			"args": ["/path/to/arango-server/build/index.js"],
			"env": {
				"ARANGO_URL": "your_database_url",
				"ARANGO_DB": "your_database_name",
				"ARANGO_USERNAME": "your_username",
				"ARANGO_PASSWORD": "your_password"
			}
		}
	}
}

環境変数

サーバーには次の環境変数が必要です。

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アプリでの使用

Claude App で ArangoDB MCP サーバーを使用するデモ

Cline VSCode拡張機能を使用する

Cline VSCode拡張機能を使用したArangoDB MCPサーバーの使用デモ

すべてのユーザーを照会:

{
  "query": "FOR user IN users RETURN user"
}

新しいドキュメントを挿入します:

{
  "collection": "users",
  "document": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}

ドキュメントを更新します。

{
  "collection": "users",
  "key": "123456",
  "update": {
    "name": "Jane Doe"
  }
}

ドキュメントを削除します。

{
  "collection": "users",
  "key": "123456"
}

すべてのコレクションを一覧表示します:

{
} // No parameters required

バックアップデータベースコレクション:

{
  "outputDir": "./backup" // Specify an absolute output directory path for the backup files (optional)
  "collection": "users" // Specify a collection name to backup (optional) If no collection name is provided, all collections will be backed up
  "docLimit": 1000 // Specify the maximum number of documents to backup per collection (optional), if not provided, all documents will be backed up (not having a limit might cause timeout for large collections)
}

新しいコレクションを作成します。

{
  "name": "products",
  "type": "document", // "document" or "edge" (optional, defaults to "document")
  "waitForSync": false // Optional, defaults to false
}

注: サーバーはデータベース構造に依存せず、ArangoDB のドキュメントおよびエッジコレクションモデルに従っている限り、任意のコレクション名または構造で動作します。

免責事項

開発目的のみ

このツールはローカル開発環境専用です。技術的には本番データベースへの接続も可能ですが、重大なセキュリティリスクが生じるため、推奨されません。本番環境データの保護と懸念事項の分離を維持するため、本ツールは開発データベースでのみ使用しています。

発達

リポジトリをクローンする
依存関係をインストールします:
```
npm run build
```
自動リビルドを使用した開発の場合:
```
npm run watch
```

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが困難になる場合があります。開発にはMCP Inspectorを使用してデバッグを行うことをお勧めします。

npm run inspector

インスペクターは、ブラウザでデバッグツールにアクセスするための URL を提供します。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

MCP Server for ArangoDB