Vectra MCP

🚀 Vectra MCP 服務器

Vectra MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，用於與 Vectra 知識庫進行交互。它使用 TypeScript 編寫，提供了管理和查詢 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

運行服務器（監聽在標準 I/O）

node build/index.js

使用自動重建進行開發

npm run watch