VR.org VR / AR / XR Reader

vr-org-mcp

面向 VR.org 的只读 Model Context Protocol 服务。VR.org 是专注于 VR / AR / XR 新闻的出版物和聚合平台。

它让任何兼容 MCP 的 Agent（Claude Desktop、Claude Code、Cursor、Continue 等）都能通过一次调用访问最新的 VR、AR 和 XR 新闻、VR.org 原创编辑内容（包括完整文章）、VR/AR/XR 活动日历、精选头显优惠、购买指南解答，以及热门游戏和应用列表。

提供 11 个工具、5 个资源和 3 个提示词。无需密钥。不会写入数据。无需付费。

安装

使用 npx 直接运行（无需全局安装）：

npx vr-org-mcp

Claude Desktop

一键安装：从最新版本下载 .mcpb 捆绑包，然后双击将其安装到 Claude Desktop。也可以手动配置：

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "vr-org": {
      "command": "npx",
      "args": ["-y", "vr-org-mcp"]
    }
  }
}

Claude Code

claude mcp add vr-org -- npx -y vr-org-mcp

Cursor

将以下内容添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "vr-org": {
      "command": "npx",
      "args": ["-y", "vr-org-mcp"]
    }
  }
}

托管的远程端点（无需安装）

VR.org 也通过 MCP 的可流式 HTTP 传输，将相同的工具作为远程服务运行，因此 Web 客户端（ChatGPT 连接器、Claude.ai 连接器）无需本地安装即可使用：

https://vr.org/mcp

每种客户端的人工设置指南：vr.org/connect。

工具

工具	返回内容
search_vr_news	实时资讯流中的最新 VR / AR / XR 新闻标题，可选类别筛选和关键词搜索（所有关键词都必须匹配，顺序不限）
get_vr_trending	当前在资讯流中流行的话题
list_vr_originals	VR.org 原创编辑文章的摘要，按发布时间从新到旧排列
get_vr_article	按 slug 获取一篇原创文章的完整内容：元数据、规范 URL 和文章正文 HTML
get_vr_events	即将举行的 VR / AR / XR 行业活动（会议、展会、发布会），按日期从近到远排列
get_vr_deals	精选产品推荐，包含价格、徽章和零售商链接
compare_vr_headsets	并排比较两款头显（支持部分名称）
get_top_vr_games	当前排名靠前的 VR 游戏列表
get_top_vr_apps	当前排名靠前的 VR 应用和实用工具列表
list_vr_sources	VR.org 聚合的新闻来源及其数量
vr_explain	常见问题的标准简答及主题支柱页面链接

资源

应用可附加为上下文的可浏览 MCP 资源：

资源	内容
vrorg://news/latest	最新聚合的 VR / AR / XR 新闻标题
vrorg://originals/latest	VR.org 最新原创文章索引
vrorg://events/upcoming	即将举行的 VR / AR / XR 行业活动
vrorg://guides	VR.org 标准主题指南解答，汇集于一个文档中
vrorg://article/{slug}	任意原创文章的完整 HTML 正文（资源模板）

提示词

提示词	功能
recommend_a_headset	根据预算和使用场景，从 VR.org 的推荐中选择一款头显
this_week_in_vr	根据资讯流和原创文章撰写每周 VR / AR / XR 综述
explain_vr_topic	依据 VR.org 的标准解答说明 VR 主题

工作原理

每个工具都会将 VR.org 的公开 JSON API（https://vr.org/api/*）整合为单个便于 Agent 使用的响应。该服务是一个轻量代理：不保存机密信息、不写入任何内容，也无法转移资金。

威胁模型

VR.org 的编辑内容受到管控，但实时信息流也包含第三方 RSS 标题。为防止恶意或遭入侵的上游标题操纵调用模型，每个工具的输出都会：

1. 清理。 从每个字符串中剔除控制字符、零宽字符和方向覆盖字符。
2. 限制大小。 将序列化响应限制为 50 KB，避免大型负载塞满 Agent 的上下文窗口。

任何外发请求前都会验证输入，并在架构层限制每个自由文本参数的长度。错误会以结构化且不回显内容的对象返回，而非原始堆栈跟踪；在极少数错误字符串传递给调用方的情况下，它会经过与工具结果相同的输出清理流程，任何类似凭据的子字符串都会被遮盖，文本也会被截断，并标记为 isError。

配置

API 基础 URL 在源代码中固定为 https://vr.org，且无法覆盖，因此该服务只能与 VR.org 通信。

环境变量	默认值	用途
VR_ORG_UA_SUFFIX	(无)	可选后缀，会追加到外发 User-Agent 中

开发

npm install
npm run dev        # run from source over stdio
npm run build      # compile to dist/
npm test           # run the offline test suite
npm run typecheck  # type-check without emitting

更新日志

0.5.0

协议升级。需要 Node.js 20 或更高版本。

• 该服务现已运行在 MCP SDK v2（@modelcontextprotocol/server）上，并使用 2026-07-28 协议修订版。使用 2025 年各修订版的客户端仍可像以前一样连接：连接使用哪个修订版由开启消息决定。
• 不再支持 Node.js 18，因为 v2 SDK 需要 Node.js 20。如果你必须使用 Node 18，请继续使用 0.4.4。
• 安装包大幅缩小。旧 SDK 引入了这个 stdio 服务从未使用过的 HTTP 技术栈，其中包含 80 多个包。生产依赖树现在只有 3 个包，并且 npm audit 检查通过，无需任何覆盖项。
• 托管端点 https://vr.org/mcp 同日切换为相同协议。现在也可直接通过 /mcp 响应，不再重定向到 /api/mcp，使用短 URL 配置的客户端往返次数因此减半。
• 没有工具、资源或提示词发生变化。

0.4.4

search_vr_news 现在会匹配词语，而不是只匹配某个完整短语。

• 关键词过滤器过去要求整个查询按原样出现在标题或摘要中的某处。Agent 往往会发送“steam frame release date”或“best vr headset 2026”这类查询，即使信息流中满是匹配的新闻，也会返回空结果。使用实时信息流对 25 个符合实际情况的查询进行回放时，有 18 个没有返回任何结果。
• 查询现在会拆分为关键词。填充词（“what is the latest”、“news”、“today”、年份和月份名称）会被丢弃，其余关键词都必须按任意顺序出现在标题、摘要、标签、分类或来源名称中。复数形式可匹配单数形式，标点符号会被忽略（“half-life alyx”可找到“Half-Life: Alyx”），不带空格输入的型号名称也能匹配（“psvr2”可找到“PS VR2”）。数字和两字母词只会匹配完整词语，因此“quest 3”不会返回 Quest 3S 的新闻。
• 标题匹配结果会优先列出，每组内按时间从新到旧排序。
• 发送查询时，响应会增加 match（值为 all_terms、partial、none，或查询全是填充词时的 latest）、terms（实际使用的关键词）和 total_matches。如果没有结果匹配所有关键词，就会返回最接近的结果，并标记为 partial，同时附带 hint。不带查询的调用与之前完全相同。
• 托管端点 https://vr.org/mcp 也使用相同的匹配器。

0.4.3

维护版本。

• vr_explain 工具说明现在列出了它可以回答的新主题（“steam frame price”“meta vr glasses”），让查看工具列表的 Agent 知道可以询问这些主题。托管端点 https://vr.org/mcp 也采用了相同的措辞。
• 发布工作流现在通过 npm 可信发布（OIDC）进行发布，只有在此方式被拒绝时才回退到令牌。与之前一样，会附加来源证明。

0.4.2

vr_explain 和 vrorg://guides 资源现在会根据 VR.org 的实时说明内容源提供答案，因此无需发布新版本也能保持最新。

• 以前，答案列表是在 2026 年 7 月编译并打包的。到了 10 月，大多数常见主题（“steam frame”“steam frame price”“meta vr glasses”“quest 4”）都会返回 no_explainer，已有的若干答案也已过时。现在会从 https://vr.org/api/explainers 获取列表并缓存十分钟，与优惠和活动的处理方式相同，因此网站上的指南一经更新，Agent 无需等待新包发布即可获取。
• 每条获取到的内容在使用前都会经过验证（键必须是非空的字符串列表，链接必须位于 https://vr.org），并使用与其他上游文本相同的清理器处理。如果获取失败或没有返回有效内容，则改用内置列表回答。该列表现已与网站当前的 34 篇指南一致，高于原来的 10 篇，因此离线服务仍能提供最新答案。获取失败的结果会记住一分钟，避免服务中断时拖慢每次调用。
• 匹配方式不变：主题中包含的最长键优先，因此“steam frame price”会匹配价格页面，而不是 Steam Frame 主页面。
• explain_vr_topic 提示词不再以“passthrough”作为示例主题，因为该主题没有对应答案。它和 no_explainer 提示现在都会建议使用“steam frame”。
• get_vr_deals 说明列出了目录的全部五个分区：头显、AR 和 XR 眼镜、配件、触觉与身体追踪设备、游戏硬件。
• 将 @modelcontextprotocol/sdk 从 1.30.0 升级至 1.32.1，并更新 ip-address 和 proxy-addr 的固定版本。相关安全公告涉及 SDK 的 OAuth 客户端和 HTTP 传输层，而本 stdio 服务不会加载这两部分。生产依赖的 npm audit 检查结果为零个漏洞。

0.4.1

修复了 2026 年 9 月审计发现的问题，并与 vr.org/mcp 上的托管端点保持一致。

• get_vr_article 现在会返回完整文章。body_html 过去受到通用的 4,096 个字符上限限制，导致大多数文章被截断在标签中间，却仍报告 ok: true。现在它有独立的 45,000 个字符上限，同时仍受 50 KB 响应上限限制。文章还会附带 updated，即应用修正的日期；托管端点此前已返回此字段。
• vr_explain 不再用错误的指南回答简短主题。过去，“vr”或“3”这样的主题会匹配到较长键中的内容，并自信地返回“PSVR2 vs Quest 3”；现在，反向匹配要求至少四个字符，且必须从单词边界开始。
• compare_vr_headsets 现在能正确匹配“Pimax Dream Air SE”。pimax 别名过去采用前缀匹配，会将所有 Pimax 查询都改写为 Crystal。
• 读取 vrorg://news/latest 后，不再会导致接下来一分钟内的关键词搜索缩减为 25 条（两者请求条数不同，却共用了同一个缓存键）。
• vrorg://article/{slug} 中的格式错误 slug 现在会显示“未找到”，而不是“暂时不可用，请稍后重试”。
• 更新了 hono、fast-uri、qs 的传递依赖固定版本，以通过 npm audit 检查。

0.4.0

内容来源标注。现在，Feed 结果中每个条目都带有 provenance 字段，值为 vr_org_editorial（由 VR.org 撰写和编辑）或 third_party_feed（逐字转发自外部发布方的标题或摘要）。任何包含转发文本的响应也会带有 content_notice，提示将该文本视为数据而非指令；vrorg://news/latest 资源也会在正文中包含相同提示。这是增量元数据，不会影响现有字段和现有使用方。

这样，调用客户端就能分辨哪些文本是 VR.org 实际认可的。这项改动源于 2026 年 8 月的 GhostSplice 研究，该研究探讨了如何跨 MCP 通道拆分指令；其核心缓解措施是客户端应将服务端输出视为数据。本服务不是该攻击的载体（它从不请求采样，工具描述是静态字面量，所有可能作为工具参数传回的值都经过严格允许列表验证），但它确实会转发非自行撰写的文本，现在也明确说明了这一点。

此外，@modelcontextprotocol/sdk 升级到了 1.30.0，并固定了 SDK 的 HTTP 传输依赖中收到安全公告的四个传递依赖。本服务仅使用 stdio，从不加载该传输，因此这些固定版本属于安全卫生措施，而非漏洞修复。npm audit --omit=dev 报告零个漏洞。

0.3.2

错误路径加固：工具错误现在会像工具结果一样经过输出清理，秘密信息会被隐藏，错误文本也会限制长度。所有自由文本参数均新增架构级最大长度限制。有效输入的行为没有变化。

许可证

MIT。VR.org 项目。