关于 Voris
Voris 是连接 MCP 客户端与托管 Voris 分析服务的本地代理。它转发协议消息,不实现工具或访问数据库;身份验证、权限范围、速率限制和审计由托管服务处理。
主要功能
- 01桥接 stdio 与托管 HTTPS 端点
- 02转发 JSON-RPC 消息
- 03将连接限定到单个站点
- 04将协议输出与诊断信息分开
适用场景
- 01将本地 MCP 客户端连接到 Voris
- 02通过编辑器 Agent 或 CLI 使用 Voris 分析
MCP 相关
该程序将本地 MCP 客户端的 stdio 连接桥接到基于 Streamable HTTP 的托管 Voris MCP 服务。工具和访问控制由托管服务提供和执行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@voris-ai/mcp
voris-mcp 是一个轻量的 stdio ⇄ HTTPS 代理,可将本地 MCP 客户端(Claude Desktop、编辑器 Agent、命令行工具)连接到托管的 Voris MCP 服务:https://mcp.voris.ai/mcp。
它通过 Streamable HTTP,在客户端的 stdio 通道与托管端点之间原样转发 JSON-RPC 消息。它不包含工具逻辑,也不访问数据库——所有管控(身份验证、作用域、速率限制、审计)都由托管服务负责。每个连接仅限于一个站点,由你的密钥确定。
使用方法
MCP 客户端会将 voris-mcp 作为子进程启动,并通过其 stdin/stdout 使用 MCP。通过环境变量提供你的密钥:
VORIS_API_KEY=vor_mcp_… voris-mcp
Claude Desktop 配置示例:
{
"mcpServers": {
"voris": {
"command": "voris-mcp",
"env": { "VORIS_API_KEY": "vor_mcp_…" }
}
}
}
选项
VORIS_API_KEY(必需)——你的 Voris MCP 连接密钥,可在设置 → AI 连接中生成。该密钥会通过Authorization: Bearer …发送到托管端点。如果未设置,voris-mcp会向 stderr 写入一条消息,并以代码1退出。--endpoint <url>——覆盖托管端点(默认值为https://mcp.voris.ai/mcp)。主要用于本地开发;也接受--endpoint=<url>。
所有诊断信息都会写入 stderr;stdout 仅承载 MCP 协议流,因此客户端收到的内容不会受到干扰。
状态
此版本不会将 voris-mcp 发布到 npm。 此处会构建软件包并对 tarball 进行测试;公开发布到 npm 将在下一阶段(A042)进行。在此之前,请生成你的密钥,并从 Voris 控制面板复制托管连接片段。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。