mcpField
V
Voris

Voris

本地服务
docs.voris.ai数据与分析015 周前更新

关于 Voris

Voris 是连接 MCP 客户端与托管 Voris 分析服务的本地代理。它转发协议消息,不实现工具或访问数据库;身份验证、权限范围、速率限制和审计由托管服务处理。

主要功能

  1. 01桥接 stdio 与托管 HTTPS 端点
  2. 02转发 JSON-RPC 消息
  3. 03将连接限定到单个站点
  4. 04将协议输出与诊断信息分开

适用场景

  1. 01将本地 MCP 客户端连接到 Voris
  2. 02通过编辑器 Agent 或 CLI 使用 Voris 分析

MCP 相关

该程序将本地 MCP 客户端的 stdio 连接桥接到基于 Streamable HTTP 的托管 Voris MCP 服务。工具和访问控制由托管服务提供和执行。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"ai-voris": {
"command": "npx",
"args": [
"-y",
"@voris-ai/mcp"
],
"env": {
"VORIS_API_KEY": "<VORIS_API_KEY>"
}
}
}
}
启动命令npx -y @voris-ai/mcp
需要配置的环境变量
VORIS_API_KEY密钥Your Voris MCP API key. Generate one in the Voris dashboard under Settings > AI Connections.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@voris-ai/mcp0.0.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

@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 控制面板复制托管连接片段。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。