星雲大師 MCP — Partner Access Guide
Retrieval over the 星雲大師全集·佛教叢書 (books.masterhsingyun.org), served over the Model Context Protocol (MCP).
星雲大師 (Hsing Yun, 1927–2023), founder of 佛光山 and a leading voice of Humanistic Buddhism (人間佛教); his 佛教叢書 is a structured exposition of doctrine, history, sutras, schools, ritual, and application, organized 冊 → 篇 → 章.
Third-party reference corpus — not Master Sheng Yen. Every result is attributed to
星雲大師.
1. Endpoint & auth
| Base URL | issued on onboarding (<YOUR_ENDPOINT>) |
| Transports | GET/POST /sse (SSE) · POST /mcp (streamable-HTTP) |
| Protocol | MCP 2024-11-05 |
| Auth | Authorization: Bearer <YOUR_API_KEY> (or X-API-Key: <YOUR_API_KEY>) |
Your API key is issued privately; every request must carry it (no/invalid key → 401).
Connect any MCP-compatible client by pointing it at the /sse URL with the
Authorization header — same shape as the DDC guide §3.
2. Tools
| Tool | Purpose |
|---|---|
retrieve ⭐ | Natural-language retrieval; returns section-grounded Passage objects (matched snippet + section-budget context, the 章 body merged within its 篇 to the grounding floor). |
list_books | 冊 catalog: book_id, book_title, unit (章) count. No args. |
get_book_outline | A 冊's 章 (table of contents) by book_id, with the parent 篇. |
get_chapter | Fetch one 章's full body by its record_id. |
retrieve
| arg | type | default | description |
|---|---|---|---|
query | string | — | 檢索詞（繁體佳）；一個 query 對應一個概念／面向。 |
k | int (1–20) | 5 | Max passages after rerank. |
min_score | number | 0.30 | Rerank-score floor; 0.0 disables. |
// retrieve
{ "query": "人間佛教的意義", "k": 5 }
Returns a list of Passage objects, each:
{
"section_id": "hsingyun:3853#002",
"source": "hsingyun",
"attribution": "星雲大師",
"title": "…section label (navigation, not a citation)…",
"snippet": "…the matched span…",
"context": "…the matched span's 章 section, sized to a grounding budget — the basis…",
"citation": "《佛教叢書·教史》…",
"source_url": "https://books.masterhsingyun.org/ArticleDetail/artcle3853",
"book_id": "053佛教叢書11 教史(1)",
"mid_id": "第一篇 印度篇",
"score": 0.96
}
Ground answers in context; cite section_id + attribution; link with source_url.
title is a navigation label, never a citation.
Browse: list_books → get_book_outline → get_chapter
// list_books → [{ "book_id": "053佛教叢書11 教史(1)", "book_title": "…", "unit_count": 40 }, …]
// get_book_outline
{ "book_id": "053佛教叢書11 教史(1)" }
// → 章: [{ "record_id": "3853", "mid_id": "第一篇 印度篇", "title": "第六章 佛教的轉輪聖王" }, …]
// get_chapter
{ "record_id": "3853" }
3. Notes & support
- Encoding: Traditional Chinese (繁體中文), UTF-8.
- Access: keys are issued per service; tell your onboarding contact which corpora and expected load you need. See the Partner Overview for the full MCP family.