安装
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。