Vectra MCP Server

Vectra MCP サーバー

Vectra ナレッジベースとやり取りするための Model Context Protocol（MCP）サーバーです。

この 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：ファイルと、それに関連付けられた Vectra の埋め込みを削除します。
  • 入力：fileId（文字列、必須）
• get_arangodb_node：キーを指定して、基盤となる ArangoDB データベースから特定のノードを直接取得します。
  • 入力：nodeKey（文字列、必須。例：chunk_xyz または doc_abc）

（入力スキーマの詳細については、src/tools.tsを参照してください）

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

サーバーを実行します（stdioで待ち受けます）：

node build/index.js

自動再ビルドで開発する場合：

npm run watch