Taiwan Legal RAG：台灣法律 MCP 伺服器與 CLI（twlegalrag）

🌐 Language / 語言 / 言語

繁體中文 ・ English ・ 日本語

免費、免註冊、免 API key 的台灣法律 MCP 伺服器：在 Claude、ChatGPT、Codex、Cursor 加入 https://tlr.dr-legal.com.tw/mcp 一個網址，AI 助理就能直接語義檢索 2,250 萬筆台灣裁判書、 行政函釋與憲法法庭裁判，逐筆附引用查核。另提供同一後端的公開原始碼 CLI（twlegalrag）。

Free, no-signup, no-API-key Taiwan legal MCP server + source-available CLI, backed by Legal Detective's 22M-judgment semantic retrieval infrastructure.

Taiwan Legal RAG CLI retrieves Taiwan court judgments from Legal Detective's public TLR endpoint and packages them for use with your own AI tools. It does not generate legal advice, does not call any LLM, and does not guarantee semantic faithfulness of third-party model outputs. Its built-in citation check only verifies whether cited judgments belong to the retrieved bundle.

作者：黃思齊（Aaron Huang）律師，法律偵探／Dr.Legal 創辦人（個人介紹）。

繁中：Taiwan Legal RAG CLI 是一個公開原始碼命令列工具,連接法律偵探建置的 2,250 萬筆 台灣裁判語義檢索服務（22,527,498 筆，截至 2026-08-22）,讓你能用自然語言搜尋判決,並將檢索結果帶入自己的 AI 工具使用。

資料涵蓋（統計截至 2026-08-22，取自 production 資料庫）

一、法規範（依法位階）

二、裁判與裁決

三、輔助資料

法規範與裁判之取用方式：裁判書、行政規則走 hosted MCP 的語義檢索與字號精確查詢； 憲法、法律、命令於 dr-legal.com.tw 站上檢索。

裁判書為每日增量同步（司法院公開資料釋出有數日時差，極新宣判的裁判請以官網為準）。 以上數字直接取自 production 資料庫並標註統計日，非估計值。

裁判書明細（依法院層級／案件類別）

行政規則發布機關明細（依文號編排者 74,685 筆）

（機關名稱依函釋原始發文機關記載，含已改制機關之歷史名稱，如「行政院環境保護署」 「前司法行政部」；改制前後分列、不合併，以保留原始發文脈絡。）

為什麼不一樣

這不是一般關鍵字判決搜尋工具。背後連到的是法律偵探長期建置的 TLR 檢索服務：

• 22,527,498 筆台灣裁判資料（截至 2026-08-22），經過結構化處理與向量化。
• 語義模糊搜尋——不是只靠案號、法院、關鍵字，用自然語言就能找到 「概念相近但用詞不同」的判決；另有詞彙精確檢索模式供專有名詞查找。
• 案號精確調卷——完整裁判字號自動切換精確調卷；查無時明確告知 「查無不代表該裁判不存在」，不拿語義近似結果充數。
• 審級關聯 case_history——隨判決附上資料庫記錄的上下審級與主文 「廢棄／駁回」旗標，引用前就能看到判決是否已被上級審廢棄。
• 行政規則雙工具——字號精確查詢（附效力狀態：已驗證有效／未驗證／已廢止／ 停止適用／已被取代）與語義檢索成對使用；函釋與判決嚴格分流，不混排、 不得引為法院見解。詳見 docs/mcp-anchor.zh.md。
• 引用防護是一等公民——allowed_citations 白名單（只含實際讀入理由全文的 判決）、unread_candidates 標記、寫進每個 bundle 的驗證指示，加上 CLI 端的 citation check。整套設計針對法律 AI 最痛的幻覺型態：字號真實、見解捏造。
• 本 CLI 不內建判決庫，也不暴露後端模型權重、向量索引或檢索管線細節； 它是連接公開 TLR retrieval endpoint 的工具。

與「官方網站 wrapper」型工具的差異

另一類常見做法是即時轉打司法院/法規官網的站內搜尋。兩者定位不同,可以互補：

官網 wrapper 的強項是即時性與官方來源直連;本工具的強項是語義檢索品質與引用 紀律。

Unlike keyword-only legal search tools, Taiwan Legal RAG CLI connects to a production semantic retrieval backend built on 22M+ Taiwan court judgments, enabling fuzzy concept-level search while keeping model weights, infrastructure, and private indexes server-side.

（措辭說明：公開原始碼的是 CLI,不是模型或向量庫;後端的檢索服務、模型權重、私有 索引都留在伺服器端,不隨本工具公開。）

它做什麼 / 不做什麼

做：用自然語言檢索判決 → 取得結構化清單、判決全文片段(excerpt)、引用連結 → 打包成 bundle 交給你自己的 AI;並可對 AI 產生的答案做 bundle 層級的引用檢查。

不做：本工具不呼叫任何 LLM、不生成法律意見、不背書任何模型輸出。答案要由 你自己選的 AI(ChatGPT / Claude / Gemini / 本地模型)生成。

內建的 citation check 能檢查什麼

check 是 bundle 層級、盡力而為的字串檢查,只驗：

• 答案引用的判決字號是否在 bundle 內(抓「引用了不在 bundle 的字號」= 疑似捏造);
• 是否引用 bundle 外、或不存在的判決;
• 引文存在性(bundle 層級):答案宣稱「法院說……」的逐字句,是否出現在 bundle 文字的某處。

它不能檢查什麼（重要）

• 引文是否出自答案所指的那一篇判決(存在性檢查只看「整個 bundle 裡有沒有這句」, 不綁定到特定判決);
• 法院見解是否讀對;
• 是否把當事人主張(原告/被告/上訴人)當成法院見解;
• 是否把附帶論述當成判決核心權威;
• paraphrase(改寫)型的見解幻覺。

這些都需要閱讀判決全文才能判斷——這也是為什麼 bundle 內附上判決全文片段與 verification instructions,要求下游模型自行核對。pass 只代表「引用的字號身份對得上 bundle」,不代表「法律推論正確」或「引文確實出自那篇」。 另外,check 只比對 bundle 內的內容,不是整個法律偵探資料庫——若你事後自己開判決全文再改寫答案, check 仍只看 bundle 當初打包的片段。

安裝

pip install twlegalrag

只依賴 httpx / typer / rich。不需要任何 LLM 套件或金鑰——本工具不呼叫 LLM。

使用

# 1) 純檢索 — 列出符合的判決
twlegalrag search "勞資 加班費" -n 5 --read

# 2) 打包 — 產生可交給任何 AI 的 bundle ★主流程
twlegalrag pack "車禍對方全責,我可以求償什麼?" -o bundle.json
#   → 把 bundle.json 貼給 ChatGPT / Claude / Gemini,要求它只引用 bundle 內的判決

# 3) 引用檢查 — 對任何 AI 產生的答案做 bundle 層級檢查
twlegalrag check bundle.json answer.txt

# 服務是否正常
twlegalrag health

pack 產生的 bundle 包含 query、每筆判決的 citation_id(J1, J2, ...)、 citation_text、citation_url、doc_id、Layer-1 listing、fulltext_excerpt (判決理由的擷取片段,有長度上限)、case_history(資料庫記錄的審級關聯,v1.1)、 allowed_citations,以及一段 verification_instructions,明確要求下游模型只引用 bundle 內判決、把不支持的命題標為 unverified。stderr 也會印一段 AI USE NOTICE。

v1.1 起 verification_instructions 額外包含見解層自查規則(OPINION-LAYER SELF-CHECK),要求下游模型在作答後逐一回頭核對:(a) 歸給某判決的見解確實出現在 該判決的 excerpt(不是別篇的、不是推論的);(b) 裁判結果方向(勝訴/敗訴/廢棄/駁回/ 發回)沒有顛倒;(c) case_history 顯示已被廢棄的判決,不得當成現行有效見解引用。 這與 check 的 bundle 層級字號檢查互補——字號真實不代表見解真實,見解層的核對 只能由讀了全文的模型自己做,這些規則就是把該動作寫進每個 bundle 的硬性指示。

allowed_citations 是「可引用判決」白名單,只含實際讀入理由全文的判決。CLI 的 pack 會讀入每一筆判決,所以兩者一致。Hosted Remote MCP 的 search_bundle (/v1/pack)若 read_top < max_results,只讀入前 read_top 筆;其餘判決仍列在 judgments 供瀏覽,但會移到 unread_candidates(非 authority,不可引為法院論理)。 詳見 docs/mcp-anchor.zh.md。

設定(選用)

預設打公開端點 https://tlr.dr-legal.com.tw,免金鑰即可使用。若服務方發給你 API key, 可放環境變數或 ~/.twlegalrag/config.toml(已 git-ignore,切勿 commit)：

export TWLEGALRAG_TLR_BASE_URL=https://tlr.dr-legal.com.tw   # 預設
export TWLEGALRAG_TLR_API_KEY=...   # 選用；公開端點不需要，僅限服務方另行核發的企業金鑰

[tlr]
# base_url = "https://tlr.dr-legal.com.tw"
# api_key  = "..."

隱私與資料流向

先講清楚哪些東西永遠不會經過 TLR 伺服器：

• 你與 AI(Claude / ChatGPT / 本地模型)的完整對話內容、上傳的文件、AI 生成的 回答,全部發生在你與你的 AI provider 之間,從不經過 TLR。TLR 是 retrieval-only 伺服器,唯一收到的是你的 AI client 決定送出的檢索 query 字串與後續調閱的 判決編號。
• 不需要註冊帳號：公開 REST 端點免金鑰即可使用,本服務沒有使用者帳號系統, 查詢不與任何帳號身分綁定。
• 判決資料本身是台灣公開裁判書,查詢回傳的內容不含非公開個資。

其餘請務必理解的網路傳輸：

• 你的搜尋字詞 / 問題會送到 TLR 檢索端點(https://tlr.dr-legal.com.tw)以取得判決。
• TLR may log your query text, timestamp, IP-derived metadata, and result counts for retrieval-quality analysis. Do not submit personal secrets or confidential facts. Queries are not used to train generative models. (TLR 後端可能以明文記錄你的查詢字串、時間、由 IP 推得的中介資料與結果筆數, 供檢索品質分析之用。請勿送出個人機密或保密事實。查詢不會用於訓練生成模型。)
• 本工具不呼叫 LLM、不使用 server-side token;若你自行把 bundle 餵給某個 AI, 那段傳輸與費用發生在你與你選的 AI provider 之間,與本工具無關。
• 端點 API 金鑰(若有)請放環境變數,不要 commit 設定檔。

citation check 如何運作

twlegalrag/faithful/ 是一組零依賴純函式(只用標準庫 re + unicodedata)。 給定答案文字與 bundle 內判決片段,回 pass / needs_review / fail。設計上保守: 不確定時回 needs_review 而非 fail,以壓低誤報。它不呼叫 LLM、不碰資料庫,是 確定性的字串分析。

⚠️ 這個目錄是內部程式的快照,裡面有些函式(如 check_party_as_court / run_all_checks)CLI 並沒有用到。它們存在不代表 CLI 能做見解層 / 語義驗證—— CLI 只用其中兩個 bundle 層級檢查。請勿把檔案清單當功能清單。詳見 twlegalrag/faithful/VENDORED.md。

2026-08-20 服務端更新（hosted MCP / REST）

• bundle 回應附 result_token，可對 bundle 內任一判決直接調閱全文。
• 每筆結果附 hit_excerpt（命中段落預覽）；引用仍以理由全文為準。
• get_judgment_fulltext 支援 excerpt_offset 分頁，長判決可完整讀畢。
• 詞彙精確檢索模式（search_type: keyword / phrase）強化，適合專有名詞 與技術用語；概念性問題建議預設的 hybrid。

以上為伺服器端能力，REST 與 Remote MCP 介面即日可用。CLI v2.1.0 已跟進： pack 自動分頁讀完長判決（bundle 每篇全文預算加倍），並將命中段落 hit_excerpt 帶入 bundle。

其他接法（同一個 TLR 後端）

這個 CLI 是接 TLR 檢索服務的方式之一。同一個後端 tlr.dr-legal.com.tw 也支援把判決 搜尋透過 Remote MCP 直接接進你的 AI 工具。兩者填同一個 MCP 端點 https://tlr.dr-legal.com.tw/mcp,連線時會自動完成 OAuth(動態註冊,無需自行申請或 設定 API key)：

• Claude（Remote MCP）：Settings → Connectors → Add custom connector,URL 填 https://tlr.dr-legal.com.tw/mcp。
• ChatGPT（MCP connector）：在 Connectors 新增自訂 MCP server,URL 填 https://tlr.dr-legal.com.tw/mcp。
• Claude Code（Skill,走 CLI 非 MCP）：本 repo 附了一個現成的 skill 在 skills/tw-legal-rag/，把整個資料夾放到你專案的 .claude/skills/ 即可。它包裝本 CLI 的 pack 子指令，讓 Claude 在你問到 台灣判決／法律論據時自動檢索、並要求只引用 bundle 內的 citation_id。 skill 內附的 scripts/search_judgments.py 會自動定位執行檔，並處理 Windows 上