SuperAPI AI 工具集

tripitaka-mcp

tripitaka-mcp 是一个用于检索和引用巴利三藏(Tipiṭaka)内容的 MCP 服务器,让 Claude、Cursor 等 AI 代理能够查找经文、引用教法并比较不同语言的译本。它与 SuttaCentral 保持一致,收录了约 44.4 万个片段,覆盖经藏(巴利文 + Sujato 英文)、律藏(巴利文 + Brahmali 英文)和论藏(仅巴利文)。主要能力包括:混合搜索(关键词 + 语义,通过 RRF 融合)、三元组模糊关键词搜索、基于 pgvector 的语义搜索、片段级对齐的译本比较、内置 2 万条以上的巴利文词典(P. A. Payutto、PTS、DPPN)、按 ID 获取经文并生成学术引用、巴利文词形分析器(去除屈折后缀以查找词根)。每个响应都附带指向项目自有双语阅读器的可点击深度链接,便于用户一键核验原文。项目以 Dhamma Dāna 形式提供,100% 免费、仅限非商业用途。

访问官网

工具介绍

用途

tripitaka-mcp 是一个 MCP(Model Context Protocol)服务器,用于检索和引用巴利三藏(Pāli Tipiṭaka)内容。它为 AI 代理(如 Claude 或 Cursor)提供查找经文、引用教法以及跨语言比较译本的能力。项目以「法施」(Dhamma Dāna)形式提供,100% 免费,仅限非商业用途。

数据覆盖

与 SuttaCentral 保持一致,收录全部三藏(约 44.4 万个片段):

  • 经藏(Sutta):巴利文 + Sujato 英文
  • 律藏(Vinaya):巴利文 + Brahmali 英文
  • 论藏(Abhidhamma):仅巴利文(上游 bilara-data 中没有任何论藏书籍的英文)

主要能力

  • 混合搜索(Hybrid Search):结合关键词与语义搜索,通过 Reciprocal Rank Fusion(RRF)实现更高精度。
  • 关键词搜索:三元组(trigram)模糊匹配,支持跨语言对齐。
  • 语义搜索:基于向量相似度(pgvector)的语义检索。
  • 译本比较:查看并比较不同版本之间的译文,按片段级别对齐。
  • 词典桥接:内置 2 万条以上词条(P. A. Payutto、PTS、DPPN)。
  • 获取经文与引用:按 ID(如 mn1、pli-tv-bu-vb-pj1、patthana1.1)获取经文内容,并生成格式规范的学术引用。
  • 巴利文词形分析器:当词典查不到时,去除屈折后缀以查找词根(如 bhikkhūnaṁ → bhikkhu)。
  • 交叉引用 URL:每个响应中附带指向项目自有双语阅读器的可点击深度链接(巴利文 + 英文,带片段锚点以高亮被引用的偈颂)。阅读器逐字渲染 SuttaCentral 的 bilara-data,因此是权威文本。
  • 双传输模式:同时支持传统 SSE(/sse)和规范 Streamable HTTP(/mcp,MCP 规范 2025-03-26)。
  • MCP 资源:tripitaka://structure、tripitaka://sutta/{id}、tripitaka://word/{w},供将上下文固定为资源的客户端使用。
  • 精选参考页(/topics/*):六个 markdown 页面,涵盖藏经结构、入门与工具选择、地点(十六大国 + 圣地 + 宇宙观)、10 个基础主题及经典出处、约 30 位主要人物,以及基于阶段划分的佛陀 45 年弘法时间线。经文 ID 已对照实时数据校验。
  • Claude 技能:skills/tipitaka-research.md 提供一个可直接安装的工作流文件,在 Claude Desktop / Claude Code 上激活多步骤研究模式(澄清 → 核验覆盖 → 搜索 → 深入 → 引用)。
  • Postman 支持:附带 Postman collection 用于测试 API。

使用方式

免设置:连接公共 Dhamma Dāna 服务器

维护者在 tripitaka-mcp.com 运行免费公共实例。连接 Claude Desktop 只需 Node.js,无需安装、Docker 或 GPU:

  1. 查找 npx 的绝对路径(Claude Desktop 不读取 shell 配置文件,裸 npx 无法解析)。
  2. 打开 claude_desktop_config.json(macOS 位于 ~/Library/Application Support/Claude/,Windows 位于 %APPDATA%\Claude/)并添加相应条目,将 YOUR_NPX_PATH 替换为第一步的输出,YOUR_NODE_BIN_DIR 替换为该路径的父目录。
  3. 完全退出 Claude Desktop 后重新打开。左下角的 🔌 指示器应显示 tripitaka 并提供 12 个工具。

首次连接需要 5–10 秒,因为 npx 需按需下载 mcp-remote。托管服务器有速率限制(每 IP 10 请求/10 秒 + 60 请求/分钟)。

完全离线运行(pipx — 本地 SQLite,无服务器)

本地版将整部巴利文藏经打包为单个 SQLite 文件(约 120 MB),作为本地 stdio MCP 服务器运行。若 pipx 使用了非预期的解释器,可显式指定版本(3.10 或更高均可)。之后将 Claude Desktop / Cursor 指向本地命令即可,无需 npx、mcp-remote 或互联网。若需要 URL 而非 stdio,可绑定 127.0.0.1(除非另行指定)提供 HTTP 端点。

快速本地安装(推荐非开发者)

安装器从 Hugging Face(dhamma-seeker/tripitaka-mcp-dump)下载准备好的数据库转储并自动恢复,将设置时间从 2–4 小时缩短至约 5 分钟。安装器会:验证 docker、compose、openssl、curl 是否已安装;生成带随机密码的 .env;下载转储;启动数据库并恢复;设置只读角色与运行时超时;打印可直接粘贴的 Claude Desktop 配置。

开发者手动设置与生产部署

生产堆栈运行 3 个服务:db(PostgreSQL + pgvector,仅内部)、mcp-server(FastMCP,以只读用户运行)、caddy(反向代理 + Let's Encrypt + 速率限制)。详见 DEPLOYMENT.md。

托管版与本地版的差异

两者服务相同的约 44.4 万片段藏经。差异在于:search_semantic / search_hybrid 和三元组关键词索引需要 PostgreSQL + pgvector + 约 1 GB 嵌入模型,对轻量本地安装过重,因此仅托管版提供。本地模式下这两个工具不会被注册,连接客户端只会看到 9 个可用工具。本地服务器是标准 stdio MCP 服务器,可搭配本地模型(如 Ollama)与任意支持 MCP 的聊天界面实现全离线 AI 堆栈。

限制与注意事项

  • search_semantic 的向量索引仅基于 text_pali 构建(SuttaCentral 的 bilara-data 尚无泰文译本),使用未专门针对巴利文训练的多语言 MiniLM 模型。因此巴利文/英文查询较准确,泰文查询匹配松散、不推荐。对于 appamāda 等精确关键词,search_by_keyword 更精确;通用搜索以 search_hybrid 容忍度最佳。计划升级到巴利文训练的嵌入模型(如 bge-m3)并嵌入泰文版。
  • MCP 工具总数为 13 个。
  • 许可:项目聚合多个不同许可来源的数据,再分发前请完整阅读 NOTICE.md。允许用于免费/法施/教育项目及个人使用;禁止用于任何付费产品或服务(因 Payutto 词典);禁止修改词典内容。商业用途需移除词典组件或联系 Wat Nyanavesakavan 获取许可。
  • 托管服务器面向个人学习、研究与法的修习,再分发或商业使用前请参阅 NOTICE.md。