lawchat-oss/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，推薦）
bash
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：
> powershell
> 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（任何專案都能用）：
bash
claude mcp add taiwan-legal-db mcp-taiwan-legal-db --scope user
接著 /mcp 重啟連線、Claude 就會在自然語言查詢時自動用 26 個 MCP tool。
Chromium：司法院 WAF（伺服器第一次啟動、還沒有 cookies 時就會用到，見WAF 處理機制），以及文化部訴願、NCC、雲林縣等需要瀏覽器的來源，會在第一次需要時自動下載安裝（約 150MB，僅一次）。無法連外下載的環境請預先安裝：
bash
uvx --from mcp-taiwan-legal-db playwright install chromium # 僅在查詢需要瀏覽器時啟動，平時 idle
### 預設關閉的來源
內政部、衛福部、勞動部訴願與醫事懲戒需要通過官網驗證碼，預設不查詢。啟用前請確認符合各網站的使用規定與相關法令，使用責任由使用者自行承擔。
關閉時查到這些來源（例如 source="內政部"、source="訴願"），工具不連官網，只回「此來源預設關閉」和官網網址，請自行到官網查詢。要啟用，設定環境變數 MCP_TAIWAN_LEGAL_DB_ENABLE_CAPTCHA_SOURCES=1 後重新啟動；內政部、衛福部另外需要本機 OCR 依賴 [captcha]：
bash
pip install "mcp-taiwan-legal-db[captcha]"
claude mcp add taiwan-legal-db --scope user -e MCP_TAIWAN_LEGAL_DB_ENABLE_CAPTCHA_SOURCES=1 -- mcp-taiwan-legal-db
Claude Code plugin 不啟用這些來源，也不帶 [captcha]；要用請改照上面自行安裝。
## 開發環境設置
下面是 clone 來修程式 / 跑測試的流程：
bash
# 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