SuperAPI AI 工具集

vineverse-mcp

VineVerse MCP 的 stdio 桥接工具,将只能启动本地进程的客户端连接到托管的 VineVerse MCP 服务器。VineVerse 将圣经构建为知识图谱,包含经文、人物、地点、主题和希伯来语词素,支持经文搜索、逐字对照查询、交叉引用和家谱查询。该桥接包本身不添加或过滤任何功能,仅转发 JSON-RPC 消息,需要 Node 20 或更高版本,无任何依赖,也可通过 Docker 运行。VineVerse 服务免费、无需 API 密钥和账户、无广告,依靠捐赠运营。仓库代码采用 MIT 许可证,但该许可证仅覆盖桥接程序,不覆盖语料库本身。若客户端支持可流式 HTTP,可直接连接托管端点,无需此包。

访问官网

工具介绍

VineVerse MCP 是一个将圣经作为知识图谱呈现的 MCP 服务器,而这个仓库 vineverse-mcp 是它的 stdio 桥接程序。

用途

该包专门为只能启动本地进程的 MCP 客户端设计,使其能够连接到托管的 VineVerse MCP 服务器。如果客户端支持可流式 HTTP(streamable HTTP),则无需使用此包,可以直接指向托管端点。此桥接程序除了在本地进程与托管服务器之间传递 JSON-RPC 消息外,不做任何其他事情。

主要能力

VineVerse 服务器将圣经表示为知识图谱,涵盖经文、人物、地点、主题和希伯来语词素,提供经文搜索、逐字对照(interlinear)查询、交叉引用和家谱查询。该桥接程序将服务器的全部功能原样转发给 stdio 客户端,不添加也不过滤任何工具。

使用方式

使用前需安装 Node 20 或更高版本。该包没有任何依赖。

可以通过 npm 方式运行,或使用 Docker。仓库中提供了针对本地站点 checkout 的有用命令。测试会以真实子进程方式启动桥接程序,而不是导入模块,因为其中两项检查(通知不产生回复、进程退出码为 0 且响应不被截断)是进程属性而非函数属性。测试通过真实 stdio 驱动 initialize、notifications/initialized 和 tools/list,然后调用 get_passage 获取 John 3:16。测试会连接实时端点,因此失败可能意味着桥接程序或托管服务器存在问题。CI 在每次推送时运行,并每周按计划针对 Node 20 和 24 运行。计划运行是有意为之:由于测试连接实时端点,即使仓库数月未变,绿色徽章仍意味着服务器当天可以响应。

build 脚本的存在是因为托管构建器(如 Glama)会无条件执行 install 然后 build。它并非空操作,而是运行 node --check,这是无依赖单文件唯一有意义的构建步骤。

适用场景

适用于只支持启动本地进程的 MCP 客户端,需要访问 VineVerse 圣经知识图谱的场景。

限制

该包仅是一个 stdio 桥接,不提供除消息传递外的额外功能。仓库的 MIT 许可证仅覆盖桥接程序,不覆盖语料库。语料库的来源及其许可证列于 vineverse.bible/attribution。服务器的工具数量为 17 个,与托管服务器一致,此包不增不减。服务器声明一个资源 vineverse://support,标注 audience: ["user"],用于告知谁运营、费用以及盈余去向,并以原样转发。VineVerse 免费、无需密钥、无广告,依靠捐赠运营;get_support 和 vineverse://support 用于向用户提供捐赠链接 vineverse.bible/support。关于价格、具体捐赠金额、服务器性能细节等信息,资料中暂未提供。