Ramayana Book MCP Server

ramayana-mcp

用于《罗摩衍那之书》的 MCP（模型上下文协议）服务 （svenkatreddy/ramayana-mcp）。 可搜索诗节、获取梵文及英文／印地语／泰卢固语译文，并获取确定性的每日诗节。同一代码库支持三个目标：

• stdio（src/stdio.ts）——Claude Desktop、Cursor 和 Smithery 托管
• Vercel 无服务器（api/mcp.ts）——在 /api/mcp 上通过 HTTP 提供无状态 JSON-RPC （无需依赖的处理程序；SDK 的 ESM 传输会导致 Vercel 运行时崩溃）

工具

工具	功能
list_kandas	七个坎达的梵文标题和章节数
get_verse	按坎达、篇章和诗节编号获取一首诗节
get_sarga	获取一个篇章的所有诗节，可选语言筛选
search_verses	在所有四种语言中进行全文搜索，并提供摘要
verse_of_the_day	确定性的每日诗节（见下文）

另有 ramayana://kandas 资源，提供坎达／章节／诗节数量。

每日诗节

verse_of_the_day 会对日历日期进行哈希（FNV-1a，默认为 UTC 时区的 YYYY-MM-DD），并将结果均匀映射到全部 24,214 首已编入索引的诗节上。同一日期始终返回相同的诗节；传入明确的 date 即可查询其他日期。

本地设置

npm install
npm run build-index   # builds data/ from a Ramayana_Book checkout
npm run build
npm start             # stdio server

build-index 会从 RAMAYANA_BOOK_DIR 读取 Ramayana_Book 仓库 （相对于此软件包，默认路径为 ../../ramayana-modernization/repo）。

Claude Desktop 配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "ramayana-book": {
      "command": "node",
      "args": ["/absolute/path/to/ramayana-mcp/dist/src/stdio.js"]
    }
  }
}

在 Vercel 上部署（免费 Hobby 计划，无需付费）

1. 将此目录推送到新的 GitHub 仓库（在 github.com 上自行创建仓库）。
2. 在 Vercel 控制面板中：添加新项目 -> 导入仓库 -> 部署。
3. 无需构建配置；vercel.json 已配置好随函数一起打包 data/ 文件。MCP 端点为 https://<project>.vercel.app/api/mcp。

该端点为无状态（每个 JSON-RPC 请求发送一次 POST，不使用会话），符合 Hobby 计划的函数限制。让任意 MCP 客户端连接到上述 URL 即可。

在 Smithery 上发布（便于发现）

1. 将仓库推送到 GitHub（公开）——已完成：svenkatreddy/ramayana-mcp。
2. 前往 smithery.ai，使用 GitHub 登录。
3. 添加／部署 ramayana-mcp 仓库。smithery.yaml 声明了 TypeScript 运行时；Smithery 会安装、构建并从 src/index.ts 导入 createServer 和 configSchema。无需 API 密钥或配置。

Smithery 会托管该服务，并为其提供一个注册页面，可一键安装到 Claude Desktop、Cursor 和其他客户端。

数据与出处

诗节数据由 Ramayana_Book 仓库构建：

• 梵文：梵文维基文库（Wikimedia）；根据坎普尔 IIT 的校勘版恢复了 3 个章节
• 英文：Valmiki Ramayan Dataset（MIT）——M.N. Dutt 的译本（1891-1894）、坎普尔 IIT、Gyaandweep
• 印地语：Chaturvedi Dwarka Prasad Sharma 的印地语《罗摩衍那》（经许可使用）
• 泰卢固语：泰卢固语维基文库贡献者（CC BY-SA）

Ramayana_Book 译文发生变化后，请重新运行 npm run build-index。

许可证

此仓库中的服务代码采用 MIT 许可证（参见 LICENSE）。

data/ 下的诗节数据遵循其来源的许可证，而非 MIT： 梵文来自梵文维基文库（Wikimedia），英文来自采用 MIT 许可证的 Valmiki Ramayan Dataset，印地语来自 Chaturvedi Dwarka Prasad Sharma 的 译本（经许可使用），泰卢固语来自泰卢固语维基文库贡献者 （CC BY-SA）。完整出处请参见 Ramayana_Book 的 译文来源。