Vectra MCP

🚀 Vectra MCP サーバー

このサーバーは、Model Context Protocol (MCP) に基づいており、Vectra の知識ベースとのインタラクションを可能にします。TypeScript で書かれたこの MCP サーバーは、Vectra インスタンスの管理とクエリを行うツールを提供し、MCP 互換クライアントとの統合を可能にします。このサーバーは、バックエンドの Vectra API（別途実行されると仮定）と通信します。

✨ 主な機能

ツール

このサーバーは、Vectra とのインタラクションのために以下のツールを公開しています。

• create_collection：新しい Vectra コレクションを作成します。
  • 入力：name (文字列、必須)、description (文字列、オプション)
• list_collections：既存の Vectra コレクションを一覧表示します。
  • 入力：なし
• embed_texts：複数のテキスト項目を一括で Vectra に埋め込みます。
  • 入力：items (text（必須）とオプションの metadata を含むオブジェクトの配列)、collectionId (文字列、オプション)
• embed_files：複数のローカルファイルを読み取り、その内容を Vectra に埋め込みます。
  • 入力：sources (ローカルファイルパスの配列、必須)、collectionId (文字列、オプション)、metadata (オブジェクト、オプション - すべての項目に適用)
• add_file_to_collection：既に埋め込まれたファイル（ID で参照）を特定の Vectra コレクションに追加します。
  • 入力：collectionId (文字列、必須)、fileId (文字列、必須)
• list_files_in_collection：特定の Vectra コレクション内のファイルを一覧表示します。
  • 入力：collectionId (文字列、必須)
• query_collection：特定の Vectra コレクションの知識ベースでクエリを実行します。
  • 注意：このツールは常に混合検索（ベクトル + キーワード）を使用し、デフォルトでグラフ検索強化が有効になっています。
  • 入力：collectionId (文字列、必須)、queryText (文字列、必須)、limit (数値、オプション)、maxDistance (数値、オプション)、graphDepth (数値、オプション)、graphRelationshipTypes (文字列の配列、オプション)、includeMetadataFilters (オブジェクトの配列、オプション)、excludeMetadataFilters (オブジェクトの配列、オプション)
• delete_file：ファイルとそれに関連する埋め込みベクトルを削除します。
  • 入力：fileId (文字列、必須)
• get_arangodb_node：基盤となる ArangoDB データベースから特定のノードをキーで直接取得します。
  • 入力：nodeKey (文字列、必須 - 例: chunk_xyz または doc_abc)

(詳細な入力パターンについては、src/tools.ts を参照してください)

📦 インストール

依存関係のインストール

npm install

サーバーのビルド

npm run build

サーバーの実行（標準入出力で待機）

node build/index.js

自動再構築を使用した開発

npm run watch