MCP Taiwan Legal DB

mcp-taiwan-legal-db

English · 繁體中文

台灣法規、裁判書、憲法法庭裁判與卷宗、行政函釋、判解、訴願與準司法決定、立法資料、司法統計與法學文獻 — MCP Server。

讓任何 MCP 相容的 AI 助手直接存取台灣公開法律資料：

本工具即時爬取官網公開資料，請求由使用者自己的電腦發出。使用前請先讀免責聲明：使用者須自行遵守各網站的使用規定與相關法令，查詢結果不構成法律意見。

• 司法院裁判書 — judgment.judicial.gov.tw（全文搜尋 + 取得，附歷審清單）
• 全國法規資料庫 — law.moj.gov.tw（11,700+ 部法規，含官方英譯、最新公布日與施行日註記）
• 憲法法庭 — cons.judicial.gov.tw（871 筆大法官解釋 + 憲判字，含理由書全文，離線快取；受理中案件、言詞辯論、法庭之友與卷內書狀即時查詢）
• 行政機關函釋 — 法務部、勞動部、衛福部、財政部、經濟部、內政部、金管會、交通部、中央銀行、人事總處、消保處、考試院系統、臺北市、新北市等 51 個官方來源，含智慧局專利、商標審查基準；標出官網的「停止適用」與「現行」標示（即時查詢）
• 判解 — 司法院法學資料檢索系統（最高法院決議、法律問題座談、停止適用判例、院字／院解字、大法庭、精選裁判）
• 訴願與準司法決定 — 行政院、各部會與縣市政府訴願決定，公平會處分書、勞動部不當勞動行為裁決、保訓會復審／再申訴決定、金管會裁罰、工程會採購申訴、監察院案件、律師懲戒決議
• 立法資料 — 每一條歷次修正的條文與立法理由、立法歷程、立法院議案（含審查中草案）與公報紀錄、法規命令草案預告
• 統計與量刑 — 司法統計年報／月報、法務統計、《犯罪狀況及其分析》、司法院量刑資訊系統的刑度統計
• 法學文獻 — 司法院專題研究報告（含司法研究年報）、國圖期刊論文索引、GRB 研究計畫、開放取用法學期刊
• 其他規範 — 地方自治法規、條約協定與租稅協定、證交所／櫃買中心／期交所規章

以 Python 搭配 MCP Python SDK 寫成。純工具 wrapper，只連線下方「資料來源與統計」列出的官方網站（政府機關，以及國家圖書館、中研院、國立大學、證券交易所等公共機構），不發送任何其他網路請求；釋字／憲判字資料為內建離線打包。

特色

⚡ 安裝（PyPI，推薦）

pip install mcp-taiwan-legal-db

Debian / Ubuntu / WSL 注意：系統 Python 受 PEP 668 保護，直接 pip install 會被擋。請改用：

• pipx install mcp-taiwan-legal-db（推薦，自動建隔離 venv，CLI tool 標準裝法）
• 或 pip install --user --break-system-packages mcp-taiwan-legal-db

Windows / 企業部署：建議用 uv 或 pipx 裝成獨立工具，不碰系統 Python 的 site-packages：

uv tool install mcp-taiwan-legal-db
uv tool update-shell   # 把工具目錄加進 PATH，重開終端機後生效

套件目錄只讀不寫：查詢快取、WAF cookies 與每週更新的法規代碼表都寫在每位使用者自己的目錄（Windows：%LOCALAPPDATA%\mcp-taiwan-legal-db；macOS / Linux：~/.cache/mcp-taiwan-legal-db），所以裝到 C:\Program Files 等全使用者共用位置也能用。要改位置可設環境變數 MCP_TAIWAN_LEGAL_DB_HOME。

裝完後 entry point mcp-taiwan-legal-db 會在 PATH 上。接到 Claude Code（任何專案都能用）：

claude mcp add taiwan-legal-db mcp-taiwan-legal-db --scope user

接著 /mcp 重啟連線、Claude 就會在自然語言查詢時自動用 26 個 MCP tool。

Chromium：司法院 WAF fallback，以及文化部訴願、NCC、雲林縣等需要瀏覽器的來源，會在第一次需要時自動下載安裝（約 150MB，僅一次）。無法連外下載的環境請預先安裝：

uvx --from mcp-taiwan-legal-db playwright install chromium    # 僅在查詢需要瀏覽器時啟動，平時 idle

驗證碼辨識：內政部與衛福部訴願的圖形驗證碼需要本機 OCR 依賴，安裝時加上 [captcha]：pip install "mcp-taiwan-legal-db[captcha]"（uvx：uvx --from "mcp-taiwan-legal-db[captcha]" mcp-taiwan-legal-db；Claude Code plugin 已內含）。未安裝時這兩個來源會回報需要安裝，其餘來源不受影響。

開發環境設置

下面是 clone 來修程式 / 跑測試的流程：

# 1. Clone repo
git clone https://github.com/lawchat-oss/mcp-taiwan-legal-db.git
cd mcp-taiwan-legal-db

# 2. 建立並初始化虛擬環境
python3 -m venv .venv
.venv/bin/pip install --upgrade pip
.venv/bin/pip install -e .

# 3. 安裝 Playwright Chromium（供需要瀏覽器的官方來源使用）
.venv/bin/playwright install chromium

# 4. 驗證伺服器可以啟動並註冊 26 個工具
.venv/bin/python -c "
import asyncio
from mcp_server.server import mcp
print('Server:', mcp.name)
tools = asyncio.run(mcp.list_tools())
print('Tools:', [t.name for t in tools])
assert len(tools) == 26, f'Expected 26 tools, got {len(tools)}'
print('✓ Setup OK')
"

預期輸出：

Server: 台灣法律資料庫
Tools: ['search_judgments', 'get_judgment', 'query_regulation', 'get_pcode', 'search_regulations', 'get_interpretation', 'search_interpretations', 'get_citations', 'search_agency_interpretations', 'get_agency_interpretation', 'search_precedents', 'get_precedent', 'search_administrative_decisions', 'get_administrative_decision', 'get_legislative_history', 'search_constitutional_docket', 'get_constitutional_case_file', 'search_legislative_records', 'get_legislative_record', 'search_statistics', 'get_statistics', 'get_sentencing_statistics', 'search_legal_literature', 'get_legal_literature', 'search_other_regulations', 'get_other_regulation']
✓ Setup OK

上面沒報錯就完成了。Repo 根目錄已經帶一份 .mcp.json，任何在此資料夾內開的 Claude Code session 會自動載入這個 server，不需要額外註冊。

有什麼工具可以用

26 個 MCP 工具，全部唯讀，全部只連線官方公開資料庫（見「資料來源與統計」）。

法規與裁判

憲法法庭

行政函釋與判解

訴願與準司法決定

立法資料

統計與法學文獻

其他規範

工具細節

# ✅ 正確 — 查 114 台上 3753 最高法院
search_judgments(case_word="台上", case_number="3753", year_from=114, court="最高法院")

# ✅ 正確 — 全文搜尋
search_judgments(keyword="預售屋 遲延交屋")

# ❌ 錯 — 把案號放進 keyword
search_judgments(keyword="114年度台上字第3753號")

get_judgment(jid="TPSM,114,台上,3753,20251112,1")
# → history: 臺中地院 111 易 203 → 臺中高分院 113 上易 80 → … 各審級裁判（含 jid、url）

# 單一條文
query_regulation(law_name="民法", article_no="184")

# 區間、跨號多條，可混用（也接受「第184條」「247之1」）
query_regulation(law_name="民法", article_no="184~198")
query_regulation(law_name="民法", article_no="184,185,247-1")

# 不指定條號：章節目錄與條號範圍
query_regulation(law_name="律師法")

# 附修法沿革；指定條號時另回傳該條歷次條文（article_history）
query_regulation(law_name="勞動基準法", article_no="24", include_history=True)

# 官方英譯（約 970 部法律與部分命令）
query_regulation(law_name="勞動基準法", article_no="24", language="en")

search_regulations(keyword="勞動")
search_regulations(keyword="消費", exclude_abolished=True)

# 某日以後新制定／修正公布的法規（新到舊），可再依主管機關篩選
search_regulations(amended_since="2026-09-01")
search_regulations(amended_since="115-07-01", category="勞動部")

# 預設層（離線，~0ms）
get_interpretation("釋字748")

# 理由書中搜尋關鍵字
get_interpretation("釋字748", reasoning_keyword="婚姻自由")

# 在意見書中定位特定大法官
get_interpretation("釋字758", opinions_keyword="湯德宗")

# 只讀某位大法官的完整意見書
get_interpretation("釋字758", opinion_document="許宗力")

# 需要從指定字元位置開始時，回傳該位置以後的全部文字
get_interpretation("釋字777", opinion_document="吳陳鐶", opinions_offset=15000)

# 新制憲判字
get_interpretation("111年憲判字第1號")

# 全文搜尋（搜爭點 + 理由書）
search_interpretations(keyword="集會自由")

# 篩選年度（新制）
search_interpretations(keyword="言論自由", year=112)

# 列舉最後 10 筆釋字
search_interpretations(number_from=804, number_to=813)

get_citations("釋字748")
# → citations: [釋字第242號, 釋字第362號, 釋字第365號, ...]

# 附上引用前後 80 字片段
get_citations("釋字748", include_context=True)

# 往後追溯：後來哪些釋字／憲判字的主文或理由書引用了這件
get_citations("釋字748", direction="cited_by")
# → cited_by: [釋字第763號, 釋字第791號, ...]

search_constitutional_docket(keyword="勞動")                     # 受理中、案由含「勞動」的案件
search_constitutional_docket(status="amicus")                    # 正在徵求法庭之友意見的案件

get_constitutional_case_file("113年憲判字第8號")                  # 列出卷內全部公開文件與言詞辯論公告
get_constitutional_case_file("113年憲判字第8號", keyword="人性尊嚴")  # 只列出內容含關鍵字的文件並附片段
get_constitutional_case_file(document_id="492306")               # 讀單一文件全文（PDF 擷取）

# 全部來源
search_agency_interpretations(keyword="個人資料", year_from=113, year_to=114)

# 指定機關（可用逗號分隔多個；簡稱如「金管會」「衛福部」也可以）
search_agency_interpretations(keyword="加班費", agency="勞動部")
search_agency_interpretations(keyword="私募", agency="金管會")
search_agency_interpretations(keyword="時效取得", agency="地政司")
search_agency_interpretations(keyword="考績", agency="銓敘部")
search_agency_interpretations(keyword="專利要件", agency="專利")   # 智慧局審查基準只比對章名
search_agency_interpretations(keyword="加班費", agency="人事總處")
search_agency_interpretations(keyword="關係人", agency="陽光法令")

# 用發文字號找
search_agency_interpretations(doc_number="法律字第11403512580號")

# 讀全文（id 取自搜尋結果）
get_agency_interpretation("moj:FE393340")

search_precedents(keyword="借名登記")                      # 決議、座談、判例、司法解釋、大法庭、精選裁判
search_precedents(keyword="情事變更", category="決議,司法解釋")
search_precedents(keyword="借名登記", category="具參考價值裁判")
get_precedent("D:A,20170214,001")                          # 最高法院 106 年度第 3 次民事庭會議

search_administrative_decisions(keyword="個人資料", source="行政院")
search_administrative_decisions(doc_number="公處字第115060號")             # 依字號精確查詢
search_administrative_decisions(keyword="資遣", source="不當勞動行為")
search_administrative_decisions(keyword="洗錢", source="裁罰")              # 金管會裁罰案件
search_administrative_decisions(keyword="長照", source="監察院")
search_administrative_decisions(keyword="違規停車", source="臺北市,新北市")
get_administrative_decision("ey:A-115-000633")                             # 由 PDF 擷取全文

get_legislative_history("勞動基準法", "24")   # 73 年制定、105、107 年修正，各版條文與理由
get_legislative_history("民法", "1030-1")     # 民法在立法院系統分編收錄，會自動對應到「民法第四編親屬」
get_legislative_history("刑法", "339-4")      # 簡稱會轉成正式名稱「中華民國刑法」

search_legislative_records("勞動基準法", kind="bills")                 # 本屆審查中的勞基法修正草案
search_legislative_records("勞動基準法第五十五條", kind="gazette")     # 找立法者原意：法律名稱＋條次
search_legislative_records("個人資料", kind="drafts")                  # 各部會辦法、細則的草案預告
get_legislative_record("bill:202110226160000")                         # 議案全文與審議進度
search_legislative_records("條例", kind="join", status="pending")     # JOIN 法律草案預告；closed 查已結束
# JOIN 的諮詢狀態不代表法律效力。全文含預告內文及選中的一份草案／對照表 PDF；其餘附件列連結。

search_statistics(keyword="收結", source="司法統計")
search_statistics(keyword="詐欺", source="犯罪狀況")
get_statistics("moj:INF_COMMON_P/807")      # 地方檢察署執行裁判確定有罪人數

get_sentencing_statistics()                     # 列出罪名與法院
get_sentencing_statistics(crime="竊盜")          # 統計，並回傳可選的法條（law_options）與量刑因子（factor_options）
get_sentencing_statistics(crime="竊盜", law="第320條第1項", court="臺北地院", factors="累犯=是")

search_legal_literature("量刑", source="司法研究年報")
search_legal_literature("勞動派遣", source="期刊", year_from=105)
get_legal_literature("ncl:A15001353")           # 書目、摘要；有授權時附全文

search_other_regulations("違章建築", source="臺北市")
search_other_regulations("日本 所得稅", source="條約")       # 條約可用「國家 主題」
search_other_regulations("營業細則", source="證交所")
get_other_regulation("taichung:GL001385", article_no="3")   # 臺中市殯葬管理自治條例第 3 條

範例問法

「查民法第 184 條」
「搜尋跟預售屋遲延交屋有關的最高法院判決」
「釋字 748 的理由書重點是什麼」
「哪些大法官解釋討論過集會自由」
「釋字 748 引用了哪些先前的釋字」
「查 111 年憲判字第 1 號」
「勞動部對加班費有哪些函釋」
「財政部對股利的函釋，哪些已經停止適用」
「公務員未休假加班費，人事總處怎麼解釋」
「工程會對不發還押標金有什麼解釋」
「最高法院有沒有關於借名登記的決議」
「查院解字第 3829 號」
「行政院有哪些個資相關的訴願決定」
「勞基法第 24 條當初為什麼這樣修」
「這件最高法院判決的前審是哪幾件？有沒有發回？」
「勞基法第 24 條的英文版」
「列出 115 年 7 月以後修正公布的勞動部主管法規」
「勞基法現在有哪些審查中的修正草案」
「死刑案的法庭之友意見書有哪些提到人性尊嚴」
「憲法法庭現在受理了哪些勞動相關的案件」
「臺北地院竊盜累犯通常判多久」
「司法研究年報有沒有關於量刑的研究」
「臺北市有關違章建築的自治法規」
「金管會最近對洗錢防制缺失的裁罰」

註冊到你的 Claude client

依你使用的 Claude client 選對應的段落。

Claude Code (CLI)

Claude Code 會自動載入專案根目錄的 .mcp.json。這個 repo 已經內建一份：

{
  "mcpServers": {
    "taiwan-legal-db": {
      "command": ".venv/bin/python",
      "args": ["-m", "mcp_server.server"]
    }
  }
}

零設定：cd 進 repo 之後跑 claude 就好。MCP server 列表會看到 taiwan-legal-db，而且此資料夾不會有其他多餘的 server。

跟隊友分享：.mcp.json 已經 commit 進 repo。任何人 clone 下來跟著 Quick Start 跑完，就會自動完成 MCP 註冊。

加到其他專案（你想在另一個資料夾用這個 MCP）：用 claude mcp add 以 project scope 加入：

cd /path/to/your/other/project
claude mcp add taiwan-legal-db --scope project -- \
  /absolute/path/to/mcp-taiwan-legal-db/.venv/bin/python \
  -m mcp_server.server

這會在你另一個專案的根目錄寫出一份 .mcp.json。想在每個專案都能用，把 --scope project 改成 --scope user。

Claude Desktop (macOS / Windows)

Claude Desktop 使用一個全域設定檔：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Windows (Microsoft Store / WinGet / MSIX 安裝)：C:\Users\<YourName>\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

最快開啟方式：在 Claude Desktop 點選單列（不是視窗）→ Settings → Developer → Edit Config。檔案若不存在 Claude Desktop 會自動建立。

在 mcpServers 下加入以下內容（跟已有內容合併）：

{
  "mcpServers": {
    "taiwan-legal-db": {
      "command": "/absolute/path/to/mcp-taiwan-legal-db/.venv/bin/python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/absolute/path/to/mcp-taiwan-legal-db"
    }
  }
}

把 /absolute/path/to/mcp-taiwan-legal-db 換成你的實際 clone 路徑。cwd 欄位必填，Python 才找得到 mcp_server 套件。

存檔後，完全關閉並重新開啟 Claude Desktop（不是只關視窗 — macOS 用 ⌘Q、Windows 右鍵工具列圖示 → Quit）。設定檔只會在重啟時重新載入。

Claude Cowork (Pro 以上方案)

Claude Cowork 跑在 Claude Desktop 裡面，共用同一個 claude_desktop_config.json — 沒有另外的 Cowork 設定檔。任何你在 Claude Desktop 註冊的 MCP server 會自動透過 Claude Desktop SDK 橋接進 Cowork 的沙盒 VM。

設定步驟：

1. 照上面 Claude Desktop 段落把 taiwan-legal-db 加進 claude_desktop_config.json
2. 完全關閉並重新開啟 Claude Desktop — 同時也會重啟 Cowork
3. 開一個 Cowork session，taiwan-legal-db 的工具就可以用了

注意：Cowork 目前在 Claude Pro / Max / Team / Enterprise 方案都可以用，且只能存取你明確授權的資料夾。MCP server 本身跑在你的 host 上（不是 Cowork VM 裡面），透過 Desktop SDK bridge 溝通，所以不管你授權哪個資料夾給 Cowork，它都存取得到內建的資料檔。

其他 MCP 相容 client

任何符合 Model Context Protocol 規範 的 MCP client 都可以使用這個 server。啟動指令永遠是：

.venv/bin/python -m mcp_server.server

⋯⋯加上 cwd 設定為 repo 根目錄（Python 才找得到 mcp_server 套件）。設定位置請參考你使用的 client 的文件，找 mcpServers JSON 區塊寫在哪裡。

在這個 server 上面建 A2A agent

想用 A2A agent 驅動這些工具？請見 examples/agno-bindu/ — 一個社群貢獻的 A2A agent 範例。

疑難排解

ModuleNotFoundError: No module named 'mcp_server' → 你沒有在 venv 裡面跑 pip install -e .。回到 Quick Start 步驟 2。

FileNotFoundError: data/pcode_all.json → 內建的 mcp_server/data/pcode_all.json 不見或被刪了。用 git checkout mcp_server/data/pcode_all.json 還原，或觸發重新下載：

.venv/bin/python -m mcp_server.updater

MCP client 回報「伺服器啟動失敗」 → 直接跑 Quick Start 步驟 3 的驗證指令。若失敗，代表 import chain 壞了 — 看 traceback。若通過，問題在 MCP client 的啟動設定（路徑或 cwd 錯了）。

「官網瀏覽器連線或啟動失敗」 → 需要瀏覽器的來源第一次使用時會自動下載 Chromium；無法連外下載的環境請手動安裝：uvx --from mcp-taiwan-legal-db playwright install chromium（開發環境：.venv/bin/playwright install chromium）。

「官網瀏覽器查詢逾時，可能仍停在驗證頁」「官網驗證尚未完成」 → 該官網的檢查這次沒有通過，稍後再試。這不代表查無資料。

「此公開來源需要本機 OCR」 → 內政部、衛福部訴願需要 [captcha] 額外依賴：pip install "mcp-taiwan-legal-db[captcha]"。Claude Code plugin 已內含。

ssl.SSLCertVerificationError: ... Missing Subject Key Identifier → 這是 OpenSSL 3.6+ 對 TWCA Global Root CA 的廣泛 rejection，不是 certifi 舊的問題。本 repo 透過 truststore 套件讓 Python 改用作業系統原生的 trust store（macOS Security framework、Windows CryptoAPI、Linux 系統 CA），所有路徑都保留完整 SSL 驗證（verify=True），不使用 verify=False。這在 macOS、Windows 以及 OpenSSL <3.6 的 Linux 都能正常工作。OpenSSL 3.6+ 的 Linux 環境（Fedora 40+、未來的 Ubuntu LTS）目前可能仍有問題，歡迎 issue 回報。

WAF 處理機制

司法院 judgment.judicial.gov.tw 部署了 F5 BIG-IP ASM WAF，純 HTTP 請求可能被擋（回固定 245 bytes 的 "Request Rejected"）。

本專案採混合策略：

• 預設用 httpx 直接請求（~0.25s）
• 偵測到被擋（response 含 Request Rejected 或 JS challenge marker bobcmn / TSPD）自動 fallback 到 Playwright 跑一次 JS challenge
• 取得 TSPD cookies 後持久化到使用者資料目錄的 .judicial_cookies.json（0600 權限）
• 後續查詢繼續用 httpx 帶 cookies 執行

cons.judicial.gov.tw（釋字）跟 law.moj.gov.tw（法規）沒這個問題，不經過 WAF 流程。

資料來源與統計

查詢時連網的都是台灣政府機關與公共機構的公開資料庫，伺服器本身不建資料庫，只在使用者查詢的當下向官方網站取資料：

各來源的網址、查詢方式、限制與目前未收錄的來源見 SOURCES.md。

get_judgment 接受使用者傳入的 URL，mcp_server/config.py:ALLOWED_DOMAINS 以硬編碼 allow-list 限制只能是裁判書與法規兩個網域；其他工具只連上表固定網址，不接受任意 URL。下列網站的 robots.txt 不允許爬蟲（或排除特定路徑），本工具對它們只做使用者觸發的單次查詢，不批次抓取：司法院法學資料檢索系統（legal.judicial.gov.tw）、衛福部法規檢索系統（mohwlaw.mohw.gov.tw）、行政院訴願網站（appeal.ey.gov.tw）、立法院議事暨公報資訊網（ppg.ly.gov.tw）、內政部地政司（www.land.moi.gov.tw）、臺北市法規查詢系統的訴願決定全文路徑（laws.gov.taipei）、全國法規資料庫的條約查詢（law.moj.gov.tw）、財政部的 /download/ 檔案（www.mof.gov.tw）、行政院人事行政總處網站（www.dgpa.gov.tw）。證券暨期貨法令判解查詢系統（www.selaw.com.tw）載明非經授權不得轉載，櫃買中心、期交所規章只供查閱，結果都附提醒。函釋、決議、訴願決定、處分書等皆屬公文，依著作權法第 9 條不受著作權保護；期刊論文、研究報告與交易所規章則不在此列，請依各來源的使用規定引用。國家圖書館授權的全文只供個人查閱，本工具一律不寫入快取。

個資與存取限制：本工具只在使用者查詢時即時轉取官網公開的內容，不另外遮蔽、也不建資料庫；部分訴願決定（行政院 108 年以前收辦、法務部約 112 年以前、原民會）官網未遮蔽當事人姓名，結果照原樣呈現。本工具只查公開、免登入資料；可在新的瀏覽器工作階段中處理 JavaScript／Cloudflare 檢查及公開查詢驗證碼。每次只完成使用者指定的查詢與全文讀取，驗證失敗會回報錯誤，不當成查無資料；不登入、不使用員工或院內權限、不批次抓取。司法院量刑資訊系統只用公開頁面的彙總統計，官網只開放給院內使用者的個案判決清單一律不呼叫。完整說明見免責聲明。

裁判書年份涵蓋範圍：本工具即時代理司法院系統，沒有自己的資料庫，有效年份 = 司法院收錄範圍。實測（以「竊盜」為關鍵字計數）民國 89 年（2000）起每年數萬筆，81–88 年（1992–1999）合計約 2,000 筆，80 年（1991）以前為零。司法院公告其開放資料檔「收錄範圍與裁判書查詢系統相同」，因此沒有更早的公開來源。查詢 2000 年以前的裁判請預期查無或零星。

憲法法庭資料（釋字／憲判字）不在查詢時連網取得 — 它是離線打包的（old_cases.json／new_cases.json／opinions.zip），來源為 cons.judicial.gov.tw，由維護腳本離線重建。詳見 SOURCES.md。

憲法法庭資料統計

釋字 401 號以後與憲判字的大法官意見書，官網只以 PDF 附件公開，已擷取文字打包進 opinions.zip，查詢回傳的 opinion_documents 會列出每份意見書的標題、官網 PDF 連結與字數。其中 22 份 PDF 的字型無法解碼或頁面為圖片（主要是釋字 735–753 號的部分意見書），改以頁面影像逐字轉錄（回傳時標註 transcribed，引用前請核對官網 PDF）。意見書以憲法法庭網站公布的 PDF 為準；全國法規資料庫收錄的早期意見書是事後編修的版本（用字統一、修正筆誤、當事人姓名去識別化），兩者文字可能略有出入。重建方式見 scripts/build_opinions.py；官網公布新的憲判字後，用 scripts/build_new_cases.py 只補新案（含意見書）。

函釋、判解、決定書、文獻、統計、立法紀錄與憲法法庭文件回傳完整全文，不按字數截斷；法規與其他規範則依 article_no 只回傳指定的條文（一次最多 50 條），不回傳整部法規。官網搜尋分頁、關鍵字片段模式、附件數量與檔案大小限制仍在；沒有文字層的掃描檔提供原始連結。

快取

使用者資料目錄：Windows 為 %LOCALAPPDATA%\mcp-taiwan-legal-db，macOS / Linux 為 ~/.cache/mcp-taiwan-legal-db（有設 XDG_CACHE_HOME 則在其下），可用環境變數 MCP_TAIWAN_LEGAL_DB_HOME 改位置。全部清除：刪掉該目錄下的 legal_mcp.db。

pcode_all.json 自動更新

伺服器啟動時會檢查 pcode_all.json 的時間戳。如果最後一次更新在最近的週六之前，會在背景觸發從 law.moj.gov.tw 官方 API 重新抓取，結果（連同 law_histories.json 與 law_meta.json）寫進使用者資料目錄，不動套件內建檔；讀取時內建檔與使用者副本取較新者。失敗會記為 warning，不會阻擋啟動。

手動更新：

.venv/bin/python -m mcp_server.updater

專案結構

mcp-taiwan-legal-db/
├── .gitignore
├── .mcp.json              # 資料夾內 Claude Code session 自動註冊用
├── LICENSE                # MIT（程式碼）
├── DATA_LICENSE           # CC0 1.0（憲法法庭資料）
├── SOURCES.md             # 資料來源說明
├── CITATION.cff           # 學術引用格式
├── README.md              # 本檔（繁體中文）
├── README.en.md           # English version
├── pyproject.toml         # 套件 metadata 與相依
└── mcp_server/
    ├── __init__.py
    ├── server.py          # MCPServer 入口 — 定義 26 個 @mcp.tool() function
    ├── config.py          # URL、法院代碼、快取 TTL、allowed domains
    ├── updater.py         # 獨立的 pcode_all.json 更新 script
    ├── healthcheck.py     # 官方來源即時健康檢查（python -m mcp_server.healthcheck）
    ├── cache/db.py        # SQLite 快取層
    ├── data/
    │   ├── pcode_all.json          # 11,700+ 部法規（內建，~780 KB）
    │   ├── law_histories.json      # 修法沿革（內建，~9.6 MB）
    │   ├── law_meta.json           # 最新公布日、施行日註記、主管機關分類（內建，~1.2 MB）
    │   ├── old_cases.json          # 813 筆舊制釋字全文（內建，~7.4 MB）
    │   ├── new_cases.json          # 58 筆新制憲判字全文（內建，~2.0 MB）
    │   └── opinions.zip            # 大法官意見書全文，由官網 PDF 擷取（內建，~10.8 MB）
    ├── models/            # Judgment / Regulation dataclass
    ├── parsers/           # 判決與法規頁面的 HTML parser
    ├── tools/
    │   ├── judicial_search.py      # search_judgments
    │   ├── judicial_doc.py         # get_judgment（含歷審清單）
    │   ├── regulations.py          # query_regulation, get_pcode, search_regulations
    │   ├── constitutional_court.py # get_interpretation, search_interpretations, get_citations
    │   ├── constitutional_docket.py # search_constitutional_docket, get_constitutional_case_file
    │   ├── agency_interpretations.py # search_agency_interpretations, get_agency_interpretation
    │   ├── ip_guidelines.py        # 智慧局專利、商標審查基準
    │   ├── fint.py                 # search_precedents, get_precedent（司法院法學資料檢索系統）
    │   ├── admin_decisions.py      # search_administrative_decisions, get_administrative_decision
    │   ├── quasi_judicial.py       # 準司法機關決定（採購申訴、裁決、保訓會、金管會裁罰、監察院、律師懲戒、醫事懲戒）
    │   ├── appeals.py              # 各部會與縣市政府訴願決定
    │   ├── legislative.py          # get_legislative_history（立法院法律系統）
    │   ├── legislative_records.py  # search_legislative_records, get_legislative_record
    │   ├── statistics.py           # search_statistics, get_statistics
    │   ├── sentencing.py           # get_sentencing_statistics
    │   ├── literature.py           # search_legal_literature, get_legal_literature
    │   ├── other_regulations.py    # search_other_regulations, get_other_regulation
    │   ├── tls.py                  # 未送中繼憑證網站用的 TWCA 中繼憑證
    │   ├── pdf_text.py             # PDF 文字擷取（意見書、決定書、處分書、卷內文書共用）
    │   ├── waf_bypass.py           # 司法院 F5 WAF：以 Playwright 取得 cookie，缺 Chromium 時自動安裝
    │   ├── public_browser.py       # 需要瀏覽器的官網（JavaScript／Cloudflare 檢查、單頁應用程式）
    │   ├── public_captcha.py       # 圖形驗證碼的本機 OCR（[captcha] 額外依賴）
    │   └── medical_discipline.py   # 衛福部醫事懲戒公告
    └── tests/             # pytest 測試

執行測試

.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest mcp_server/tests/ -v

單元測試以 MockTransport 模擬官網，看不出官網改版。發版前、或有人回報某個來源查不到東西時，跑即時健康檢查：每個來源實際查一次、再取第一筆全文，並用幾件已知停止適用的函釋確認效力標示還讀得到。

.venv/bin/python -m mcp_server.healthcheck                          # 全部（約 150 項，幾分鐘）
.venv/bin/python -m mcp_server.healthcheck interpretations mof mol  # 只查指定工具與來源
.venv/bin/python -m mcp_server.healthcheck status                   # 只查效力標示

結果每列標 OK、THIN（取回的文字偏短）、EMPTY（查無結果）或 FAIL；有 EMPTY 或 FAIL 時 exit code 為 1。

關於

由 LawChat 維護 — 一個台灣法律 AI 平台。

• 官網：lawchat.com.tw
• 聯絡：opensource@lawchat.com.tw
• 回報問題：GitHub Issues

Best-effort 維護 — 我們會盡量跟上 upstream（司法院、法務部）頁面變動，但不保證 issue 的回覆時效。

授權

程式碼：MIT License

憲法法庭資料：CC0 1.0（公有領域貢獻）— 任何人皆可自由使用、修改及散布，無需取得授權或署名。學術引用格式請參考 CITATION.cff。

裁判書與法規資料來源：司法院、法務部（政府公開資料）。 憲法法庭資料來源：司法院憲法法庭（依中華民國著作權法第 9 條屬公有領域）。詳見 SOURCES.md。

免責聲明

非官方工具。 本工具與司法院、法務部或任何政府機關沒有隸屬關係，也未經其授權或背書。

本工具是爬蟲。 使用者每查詢一次，本工具就在使用者自己的電腦上向官網送出請求，擷取網頁、PDF 或網站前端使用的公開 API。部分網站的 robots.txt 不允許爬蟲；部分網站設有 JavaScript／Cloudflare 檢查或圖形驗證碼，本工具會在本機以瀏覽器（Playwright）或 OCR 完成，或使用網站提供的語音驗證功能；也有網站的驗證碼只在網頁前端檢查，本工具直接送出查詢表單。這些都只用於使用者觸發的單次查詢：不登入、不使用員工或特定使用者的權限、不批次下載文件全文。少數網站沒有搜尋功能，查詢時會下載它公開的清單，在本機比對並短期快取。除了伺服器啟動時預先連線司法院裁判書系統、每週更新一次全國法規資料庫開放資料的法規代碼表，本工具不在背景抓取資料，也不建立資料庫。

使用者的責任。 請求由使用者的電腦與網路發出。使用者須自行確認並遵守各網站的使用規定與相關法令（包括著作權法、個人資料保護法），並自行承擔使用的結果。請勿修改或使用本工具大量、高頻率或自動化地抓取資料，也不要把查詢結果建成資料庫或轉載；標示不得轉載的來源（如證基會法規系統）與國家圖書館授權全文只供個人查閱。

個人資料。 部分官方文件（如訴願決定、懲戒決議）在官網公開當事人姓名，本工具照原樣回傳，不另外遮蔽。使用者處理其中的個人資料時，須符合個人資料保護法的蒐集目的與合理利用範圍。

資料正確性，不構成法律意見。 查詢結果以官網當下的內容為準，可能因快取（見上方 TTL 表）、官網改版、擷取錯誤或掃描檔辨識錯誤而不完整或不正確。本工具與其結果不構成法律意見；正式引用或作為依據前，請向官方來源核對。

不提供擔保。 本工具依 MIT 授權「按現狀」提供，不提供任何明示或默示的擔保。在法律許可的範圍內，維護者對使用本工具或其結果所生的損害不負賠償責任，包括資料錯誤、官網封鎖使用者的連線，以及因使用者的使用方式所生的爭議。

在本工具之上建構的服務。 本專案的設計是在每位使用者自己的電腦上執行。若把它架設成集中式服務，或據以建構 agent、應用程式（包含 examples/ 內的範例），所有對官網的請求、資料用途與對使用者的聲明，由建構者自行負責。

給網站管理者。 若機關或網站管理者對本工具的存取方式有疑慮，或希望停止收錄、改用其他方式，請在 GitHub Issues 提出或來信 opensource@lawchat.com.tw，我們會盡速配合調整或移除該來源。