Skip to main content
Glama
Sign In
enesjakozh

MCP Server for ArangoDB

by ravenwits
npmGitHub
TypeScript
MIT License
85
18
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 動作を構成する
    • 名前、タイプ、ステータスなどのコレクション情報を返します

インストール

NPM経由でインストール

NPM 経由でarango-serverをグローバルにインストールするには、次のコマンドを実行します。

npm install -g arango-server

NPX経由で実行

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

npx arango-server

VSCodeエージェントの設定

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

  1. MCP 構成ファイルを作成または編集します。
    • ワークスペース固有の構成: ワークスペースで.vscode/mcp.jsonファイルを作成または編集します。
    • ユーザー固有の構成: オプションで、設定 (mcp) VS Codeユーザー設定でサーバーを指定して、すべてのワークスペースで MCP サーバーを有効にします。ヒント: 構成ファイルの設定方法の詳細については、VSCode の MCP 構成ドキュメントを参照してください。
  2. 次の構成を追加します。
    { "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" } } } }
  3. MCP サーバーを起動します。
    • VSCode でコマンド パレットを開きます (Mac の場合はCtrl+Shift+P 、 Cmd+Shift+P )。
    • コマンドMCP: Start Serverを実行し、リストからarango-mcpを選択します。
  4. サーバーを検証します:
    • 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 のドキュメントおよびエッジ コレクション モデルに従っている限り、任意のコレクション名または構造で動作します。

免責事項

開発目的のみ

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

発達

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

デバッグ

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

npm run inspector

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

ライセンス

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

モデル コンテキスト プロトコルを使用して ArangoDB と対話する TypeScript ベースのサーバー。データベース操作を可能にし、Claude や VSCode 拡張機能などのツールとの統合により、データ管理を合理化します。

  1. 特徴
    1. ツール
  2. インストール
    1. NPM経由でインストール
    2. NPX経由で実行
    3. VSCodeエージェントの設定
    4. Smithery経由でインストール
    5. 環境変数
  3. 使用法
    1. Claudeアプリでの使用
    2. Cline VSCode拡張機能を使用する
  4. 免責事項
    1. 開発目的のみ
  5. 発達
    1. デバッグ
  6. ライセンス

    Related Resources

    Related MCP Servers

    • MCP Server Starter

      coinselor
      A
      security
      A
      license
      A
      quality
      A production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
      Last updated -
      1
      1
      JavaScript
      MIT License

    • MCP Server Template

      stevennevins
      A
      security
      F
      license
      A
      quality
      A TypeScript-based template for developing Model Context Protocol servers with features like dependency injection and service-based architecture, facilitating the creation and integration of custom data processing tools.
      Last updated -
      1
      2
      TypeScript

    • Supabase MCP Server

      NightTrek
      A
      security
      F
      license
      A
      quality
      Enables querying Supabase databases and generating TypeScript types through the Model Context Protocol interface, supporting features like schema selection, column filtering, and pagination.
      Last updated -
      2
      9
      JavaScript
      • Apple
      • Linux

    • ArangoDB MCP Server

      lucas-deangelis
      -
      security
      A
      license
      -
      quality
      An implementation of the Model Context Protocol that enables interaction with ArangoDB databases, allowing users to perform queries, list databases and collections through natural language.
      Last updated -
      8
      3
      JavaScript
      MIT License

    View all related MCP servers

    Appeared in Searches

    New MCP Servers

    MCP directory API

    We provide all the information about MCP servers via our MCP API.

    curl -X GET 'https://glama.ai/api/mcp/v1/servers/ravenwits/mcp-server-arangodb'

    If you have feedback or need assistance with the MCP directory API, please join our Discord server