FHL Bible Tools

信望愛站聖經資料的 MCP 與 UTCP 工具：給 AI 代理用的智慧版介面，會驗證與轉換參數、跨多個 API 查詢、提供分頁。

MCP（託管）：https://fhl-tools.ai4.tw/mcp（Streamable HTTP，不需驗證）

Claude Code：claude mcp add --transport http fhl https://fhl-tools.ai4.tw/mcp
Claude（claude.ai／Desktop）：設定 → 連接器 → 新增自訂連接器，貼上上面的網址。
ChatGPT：Plugins → Add → Add custom MCP server，貼上網址，不需驗證（較舊版本：設定 → Apps & Connectors，開啟開發者模式）。
VS Code：.vscode/mcp.json 加入 {"servers":{"fhl":{"type":"http","url":"https://fhl-tools.ai4.tw/mcp"}}}
Cursor：~/.cursor/mcp.json 加入 {"mcpServers":{"fhl":{"url":"https://fhl-tools.ai4.tw/mcp"}}}

各用戶端選單名稱常會改變，以上路徑僅供參考。

UTCP：manual 在 https://fhl-tools.ai4.tw/utcp，每個工具都是可快取的 GET /tool/<name>。

原始 PHP API（不經本服務）：OpenAPI 文件與 Scalar 互動說明。

授權與內容範圍

託管服務只提供公有領域、著作權已過期，或採開放授權（GFDL、CC BY-NC-SA）的內容，例如 FHL和合本、KJV、ASV、深文理和合本、呂振中、思高、巴克禮、1933 次經、FHL 原文字典、舊約字彙分析。註釋提供信望愛站註釋（GFDL）；地點提供名稱與座標；珍本提供書目及允許自由使用的影像（GNU FDL、澳洲國家圖書館）。僅授權給信望愛站使用或授權不明的內容（多數現代譯本、新約 NA/UBS 原文、其他註釋與講道、地點說明、多數珍本影像與錄音、使徒教父、註腳、浸宣字典）不提供。每筆結果都附 source 授權說明，引用時請一併註明。詳見信望愛站著作權宣告。

本機版（全部內容）：在自己的電腦執行 stdio MCP 伺服器，直接連線信望愛站、不快取，如同自己瀏覽網站，因此預設提供全部工具與譯本。部分內容僅授權給信望愛站使用，請只供個人使用並註明出處。想套用與託管服務相同的限制，設定 FHL_RESTRICTED=1。

需要 Node.js 26（LTS；最低 20）。

git clone https://github.com/TimmyWong-TW/fhl-tools.git && cd fhl-tools
npm install -g pnpm
pnpm install && pnpm build:stdio
claude mcp add fhl -- node "$PWD/dist/stdio.mjs"

工具

`read_passage` 讀經文

讀取一段經文（正典、次經或使徒教父，依書卷自動選擇）。例：約翰福音 3:16 → {book:"JHN", chapter:3, verses:"16"}。不給 verses 則讀整章。跨章或多段請用 lookup_reference（如 "約3:35-4:2"、"約3-4"）。

參數	型別	說明
`book` 必填	`string \| integer`	書卷：USFM（JHN、1MA）、和合本書名（約、約翰福音）、英文（John）或 FHL 編號（43；次經 101-115；使徒教父 201-217）
`chapter` 必填	`integer`	章
`verses`	`string`	節：16、1-5、1,5,6、1-2,5；省略＝整章
`version`	`string` 預設 `"unv"`	譯本代碼或名稱（unv＝和合本、kjv、rcuv＝和合本2010…，見 list_versions）。僅正典適用
`strong`	`boolean` 預設 `false`	附 Strong 編號（需譯本支援）
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "book": "JHN",
  "chapter": 3,
  "verses": "16"
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/read_passage?book=JHN&chapter=3&verses=16

`lookup_reference` 查經文出處

用經文出處字串查經文，可一次多段、可跨章。例："約3:16;羅5:8"、"約3:35-4:2"、"約3-4"（整章）、"John 3:16"。僅正典。

參數	型別	說明
`reference` 必填	`string`	出處：約3:16、約 3:16-18;羅5:8、John 3:16（中英文書名皆可，多段以 ; 分隔；跨章約3:35-4:2；整章範圍約3-4）
`version`	`string` 預設 `"unv"`	譯本代碼或名稱（見 list_versions）
`strong`	`boolean` 預設 `false`	附 Strong 編號
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "reference": "約3:16;羅5:8"
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/lookup_reference?reference=%E7%B4%843%3A16%3B%E7%BE%855%3A8

`search_text` 搜尋經文

用關鍵字（或 Strong 編號）搜尋經文，可跨正典、次經、使徒教父，可限定書卷或新舊約。回傳總筆數與分頁；要下一頁時只傳 cursor。

參數	型別	說明
`query`	`string`	關鍵字；mode=greek/hebrew 時為 Strong 編號（如 25）
`corpus`	`(bible \| apocrypha \| fathers)[]` 預設 `["bible"]`	搜尋範圍：bible＝正典、apocrypha＝次經、fathers＝使徒教父；有給 books 時自動推定
`books`	`string[]`	限定書卷（可不連續）：USFM 代碼或中英文書名，如 ["MAT","MRK","LUK","JHN"]、["約","羅"]
`testament`	`"all" \| "OT" \| "NT"` 預設 `"all"`	all＝不限、OT＝舊約、NT＝新約（僅正典）
`mode`	`"text" \| "greek" \| "hebrew"` 預設 `"text"`	text＝經文關鍵字；greek／hebrew＝原文 Strong 編號（僅正典）
`version`	`string` 預設 `"unv"`	正典譯本（見 list_versions）
`page_size`	`integer` 預設 `20`	每頁筆數
`cursor`	`string`	上一頁回傳的 next_cursor；給了就只看 cursor
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "query": "愛",
  "books": [
    "MAT",
    "MRK",
    "LUK",
    "JHN"
  ],
  "page_size": 5
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/search_text?query=%E6%84%9B&books=MAT%2CMRK%2CLUK%2CJHN&page_size=5

`word_analysis` 原文字彙分析

一節經文的原文逐字分析（希臘文／希伯來文）：原文、Strong 編號、詞性、字形、原型、中文解釋。可再用 strongs_lookup 查字典。

參數	型別	說明
`book` 必填	`string \| integer`	書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66
`chapter` 必填	`integer`	章
`verse` 必填	`integer`	節
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "book": "GEN",
  "chapter": 1,
  "verse": 1
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/word_analysis?book=GEN&chapter=1&verse=1

`strongs_lookup` 原文字典（Strong 編號）

依 Strong 編號查原文字典（中英文釋義、同源字）。G＝希臘文（新約）、H＝希伯來文（舊約）。例：G25（ἀγαπάω）、H430（אֱלֹהִים）。

參數	型別	說明
`number` 必填	`string`	Strong 編號，須帶 G／H 前綴：G25、H430
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "number": "G25"
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/strongs_lookup?number=G25

`commentary` 經文註釋

讀某節經文的註釋。預設為信望愛站註釋（GFDL）；可用 list_commentaries 取得的 id 指定一本或多本。

參數	型別	說明
`book` 必填	`string \| integer`	書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66
`chapter` 必填	`integer`	章
`verse` 必填	`integer`	節
`commentary_ids`	`integer[]`	註釋書 id（見 list_commentaries）；省略＝信望愛站註釋（3）
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "book": "JHN",
  "chapter": 3,
  "verse": 16
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/commentary?book=JHN&chapter=3&verse=16

`list_commentaries` 註釋書清單

列出註釋書（id、名稱、是否可用），供 commentary／search_commentary 使用。

參數	型別	說明
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/list_commentaries

`search_commentary` 搜尋註釋

在註釋書中搜尋關鍵字，回傳命中的段落與經文範圍（預設信望愛站註釋；超過 500 筆時請用更精確的關鍵字）。

參數	型別	說明
`keyword` 必填	`string`	要在註釋中搜尋的關鍵字
`commentary_ids`	`integer[]`	註釋書 id（見 list_commentaries）；省略＝託管版為信望愛站註釋、本機版為全部
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "keyword": "尼哥底母"
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/search_commentary?keyword=%E5%B0%BC%E5%93%A5%E5%BA%95%E6%AF%8D

`topics` 主題查經

主題查經（Torrey、Nave's，英文與中譯）。用關鍵字找主題，或用 topic_id 讀某主題。

參數	型別	說明
`keyword`	`string`	主題關鍵字（英文書籍請用英文關鍵字，如 love）
`topic_id`	`integer`	主題編號（優先於 keyword）
`source`	`"all" \| "torrey_en" \| "naves_en" \| "torrey_zh" \| "naves_zh"` 預設 `"all"`	主題書：all＝全部（託管版為兩本英文）、torrey_en、naves_en、torrey_zh、naves_zh（中譯僅本機版）
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "keyword": "love"
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/topics?keyword=love

`places` 聖經地點

某章（或某節）提到的地點：名稱（英、現代、和合本…）、座標、原文編號、是否有照片。說明文字僅本機版提供。

參數	型別	說明
`book` 必填	`string \| integer`	書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66
`chapter` 必填	`integer`	章
`verse`	`integer`	省略＝整章
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "book": "JHN",
  "chapter": 2,
  "verse": 1
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/places?book=JHN&chapter=2&verse=1

`audio` 有聲聖經

某章的有聲聖經 mp3／ogg 連結（多種語言與方言）。

參數	型別	說明
`book` 必填	`string \| integer`	書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66
`chapter` 必填	`integer`	章
`recording`	`"和合本" \| "台語" \| "客家話" \| "廣東話" \| "現代中文譯本" \| "台語新約" \| "紅皮聖經" \| "希伯來文" \| "福州話" \| "希臘文" \| "spring台語" \| "spring和合本" \| "NetBible中文版" \| "全民台語聖經" \| "鄒語" \| "台語南部腔" \| "現代台語譯本" \| "現代客語譯本" \| "達悟語"` 預設 `"和合本"`	錄音版本

範例

MCP tools/call arguments：

{
  "book": "JHN",
  "chapter": 3
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/audio?book=JHN&chapter=3

`rare_books` 珍本聖經

珍本聖經：不給參數＝列出全部書目；給 id＝該書書目資料；給 book+chapter（可加 verse、id）＝找出有該經文的珍本頁面與影像連結。影像只提供授權允許自由使用者（GNU FDL、澳洲國家圖書館 NLA）。

參數	型別	說明
`id`	`integer`	珍本書籍編號
`book`	`string \| integer`	書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66
`chapter`	`integer`	章
`verse`	`integer`	節
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "book": "JHN",
  "chapter": 3,
  "verse": 16
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/rare_books?book=JHN&chapter=3&verse=16

`list_versions` 譯本清單

可用的聖經譯本（代碼、名稱、是否有 Strong 編號、是否只有新約／舊約）。

參數	型別	說明
`search`	`string`	篩選名稱或代碼

範例

MCP tools/call arguments：

{
  "search": "和合"
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/list_versions?search=%E5%92%8C%E5%90%88

`list_books` 書卷清單

書卷代碼對照：USFM、和合本書名、英文、FHL 編號（正典、次經、使徒教父）。

參數	型別	說明
`corpus`	`"bible" \| "apocrypha" \| "fathers"`	只列某一部分：bible＝正典、apocrypha＝次經、fathers＝使徒教父；省略＝全部

範例

MCP tools/call arguments：

{
  "corpus": "apocrypha"
}

UTCP／HTTP：GET https://fhl-tools.ai4.tw/tool/list_books?corpus=apocrypha

僅本機版提供的工具

這些工具的內容僅授權給信望愛站使用或授權不明；託管服務不列出也不提供，本機版預設可用。

`footnotes` 譯本註腳僅本機版

讀譯本經文中的註腳（例如現代中文譯本的「或譯」）。需註腳編號 id。

參數	型別	說明
`book` 必填	`string \| integer`	書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66
`footnote_id` 必填	`integer`	註腳編號
`version`	`string` 預設 `"tcv"`	有註腳的譯本代碼（預設 tcv＝現代中文譯本）
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "book": "GEN",
  "footnote_id": 1
}

`baptist_lexicon` 浸宣中文原文字典僅本機版

浸宣中文希臘文／希伯來文字典（僅授權給信望愛站使用，需特別授權）。

參數	型別	說明
`number` 必填	`string`	G25、H430
`simplified`	`boolean` 預設 `false`	true＝簡體輸出（輸入也要用簡體）

範例

MCP tools/call arguments：

{
  "number": "G25"
}

資料：信望愛站 https://bible.fhl.net ・說明頁最後修改 Sat, 24 Oct 2026 13:05:45 GMT ・ spec 30ccbbeaa8e42588
程式碼採 GNU AGPL-3.0 或更新版本・原始碼・ © 2026 添美網事業（Timmy Wong Co.）・需要其他授權請透過 GitHub 聯絡

FHL Bible Tools

授權與內容範圍

工具

read_passage 讀經文

lookup_reference 查經文出處

search_text 搜尋經文

word_analysis 原文字彙分析

strongs_lookup 原文字典（Strong 編號）

commentary 經文註釋

list_commentaries 註釋書清單

search_commentary 搜尋註釋

topics 主題查經

places 聖經地點

audio 有聲聖經

rare_books 珍本聖經

list_versions 譯本清單

list_books 書卷清單

僅本機版提供的工具

footnotes 譯本註腳 僅本機版

baptist_lexicon 浸宣中文原文字典 僅本機版

`read_passage` 讀經文

`lookup_reference` 查經文出處

`search_text` 搜尋經文

`word_analysis` 原文字彙分析

`strongs_lookup` 原文字典（Strong 編號）

`commentary` 經文註釋

`list_commentaries` 註釋書清單

`search_commentary` 搜尋註釋

`topics` 主題查經

`places` 聖經地點

`audio` 有聲聖經

`rare_books` 珍本聖經

`list_versions` 譯本清單

`list_books` 書卷清單

`footnotes` 譯本註腳僅本機版

`baptist_lexicon` 浸宣中文原文字典僅本機版