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，只連線下方「資料來源與統計」列出的官方網站（政府機關，以及國家圖書館、中研院、國立大學、證券交易所等公共機構），不發送任何其他網路請求；釋字／憲判字資料為內建離線打包。

---

特色

功能	說明
26 個 MCP 工具	裁判書搜尋/全文/歷審、法規查詢（含英譯與修法追蹤）、釋字/憲判字查詢、引用關係圖譜、憲法法庭卷宗、行政函釋與審查基準、判解、訴願與準司法決定、立法理由與立法紀錄、統計與量刑、法學文獻、地方法規與條約
離線快取	871 筆大法官解釋與憲判字（含理由書全文，以及從官網 PDF 擷取的大法官意見書全文）從本地資料即時回傳
引用關係圖譜	從理由書抽取所有引用的釋字/憲判字（往前追溯），或列出後來引用某件的釋字/憲判字（往後追溯），追溯憲法學說演變
全文搜尋	裁判書關鍵字搜尋 + 釋字爭點/理由書全文搜尋
混合請求策略	預設用 httpx 直打（~0.25s）；司法院 F5 WAF 或其他官網的 JavaScript 檢查擋下時，自動改用 Playwright 瀏覽器後繼續

---

⚡ 安裝（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