安裝
pip install vectara-mcp適合誰
如果你要讓智慧體應用接到 Vectara 的 Trusted RAG,走快、穩、並降低幻覺的檢索增強,這個服務對得上。官方把它寫成透過 MCP 協定提供該能力。
適合已經能 pip 裝包、並持有 Vectara API 金鑰的人。預設啟動是帶認證的 HTTP 傳輸。沒有金鑰,工作階段級設定工具無法通過校驗。
第一次只做金鑰校驗,不要把尚未點名的查詢工具當成已知函式。檢索仍會出網,也會把你的問題送到 Vectara。
3 分鐘完成第一次嘗試
官方推薦路徑是從 PyPI 安裝,並用預設的安全 HTTP 傳輸啟動。前置條件:已有 Vectara API 金鑰。
安裝:
pip install vectara-mcp
設定環境變數 VECTARA_API_KEY 為控制台簽發的真實金鑰。官方示例值是佔位寫法,不要照抄。然後啟動:
python -m vectara_mcp
官方寫明服務預設跑在:
http://127.0.0.1:8000
並且已啟用認證。把 MCP 用戶端指到該 HTTP 服務。官方沒有寫出用戶端裡應填的完整標頭欄位,不要自行發明;按用戶端對帶認證 HTTP MCP 的接法連線。
然後做一次呼叫:呼叫 setup_vectara_api_key。官方寫明它用於設定並校驗工作階段裡的 Vectara API 金鑰,是一次性設定。沒有寫出參數欄位;按用戶端展示的定義填入真實金鑰,不要寫入示例字串。
成功訊號:校驗通過,工作階段可以使用該金鑰。若失敗,先核對環境變數和工具參數是否為真實金鑰。
不要加 --stdio。第一次只走預設 HTTP。
使用案例
案例一:工作階段內校驗金鑰。呼叫 setup_vectara_api_key。官方說明是 Configure and validate your Vectara API key for the session。沒有寫出金鑰格式或是否覆蓋環境變數。成功時你應看到校驗通過。不要把它當成可以查詢語料的工具。
案例二:校驗通過後做 Trusted RAG 查詢。官方寫明本伺服器向智慧體應用提供 Trusted RAG。本頁只點名了上述設定工具,沒有寫出查詢函式名稱;打開用戶端裡本伺服器的工具清單,選描述為檢索或問答的項。不要編造未出現的函式名稱。成功時你應看到基於 Vectara 的檢索結果。查詢會出網,也可能暴露你的問題文字。
使用邊界
預設是帶認證的 HTTP。另有 python -m vectara_mcp --stdio,官方標明更不安全,僅供本機開發或 Claude Desktop,不是第一次路徑。
必須提供 VECTARA_API_KEY。官方沒有寫速率限制,也沒有寫撤銷。本頁沒有點名查詢工具,不要把 Trusted RAG 四個字當成函式名稱。本機迴環位址只表示預設監聽,不表示資料不離開本機——檢索仍會打到 Vectara。