mcp-taiwan-legal-db

English · 繁體中文

一個 Model Context Protocol (MCP) 伺服器，讓任何 MCP 相容的 AI 助手可以直接存取台灣公開法律資料：

• 司法院裁判書 — judgment.judicial.gov.tw（全文搜尋 + 取得）
• 全國法規資料庫 — law.moj.gov.tw（11,700+ 部法規）

以 Python 搭配 FastMCP 寫成。純工具 wrapper 除了上述兩個台灣官方來源之外不會發送任何網路請求。

為什麼開源這個

台灣法律公開資料本來就是免費的，開源出來讓大家不用再重新寫一次同樣的東西。

⚡ 快速上手

照順序執行下列指令。Linux / macOS / WSL + Python 3.10+ 可直接複製貼上。

# 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 瀏覽器（判決全文搜尋 + HTTP fallback 需要）
.venv/bin/playwright install chromium

# 4. 驗證伺服器可以啟動並註冊 5 個工具
.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) == 5, f'Expected 5 tools, got {len(tools)}'
print('✓ Setup OK')
"

步驟 4 的預期輸出：

Server: 台灣法律資料庫
Tools: ['search_judgments', 'get_judgment', 'query_regulation', 'get_pcode', 'search_regulations']
✓ Setup OK

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

有什麼工具可以用

五個 MCP 工具，全部唯讀，全部只打台灣政府的公開資料庫：

工具細節

搜尋司法院判決系統。支援：

• 精確案號查詢（快，HTTP GET）：設定 case_word + case_number + year_from
• 全文關鍵字搜尋（Playwright fallback）：設定 keyword
• 可依 court、case_type（民事／刑事／行政／懲戒）、year_from／year_to 過濾
• 結果自動依法院層級排序（最高 → 高等 → 地方）

重要：要查某個特定案號時，一定要用 case_word+case_number，不要放進 keyword。把案號塞進 keyword 找不到。

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

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

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

取得單筆判決的結構化全文。

• 輸入：jid（從 search_judgments 結果取得）或 url
• 輸出：{case_id, court, date, main_text, facts, reasoning, cited_statutes, cited_cases, full_text, source_url}
• 主要走 HTTP GET，失敗時 fallback 到 Playwright
• 結果快取 30 天

get_judgment(jid="TPSM,114,台上,3753,20251112,1")

單筆判決可能超過 1 萬 token。建議先用 search_judgments 取得 metadata，只在使用者明確需要時才抓全文。

查詢全國法規資料庫。

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

# 條文範圍
query_regulation(law_name="民法", from_no="184", to_no="198")

# 完整法規
query_regulation(law_name="律師法")

# 附修法沿革
query_regulation(law_name="勞動基準法", article_no="23", include_history=True)

支援 law_name（透過 get_pcode 自動解析 pcode）或直接傳 pcode。子條文如 247-1、15-1 都支援。

將法規名稱轉換為 pcode（law.moj.gov.tw 內部 ID）。

get_pcode(law_name="律師法")
# → {"success": true, "law_name": "律師法", "pcode": "I0020006", "status": "現行法規"}

get_pcode(law_name="勞基法")
# → 模糊比對到 "勞動基準法" → {"success": true, "pcode": "N0030001", ...}

涵蓋 11,700+ 部法規。內建的 pcode_all.json 會從官方 API 每週自動更新。

對法規名稱做關鍵字搜尋。分頁（每頁 50 筆），現行法規排在廢止之前。

search_regulations(keyword="勞動")
search_regulations(keyword="勞動", offset=50)  # 第 2 頁
search_regulations(keyword="消費", exclude_abolished=True)

註冊到你的 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，它都存取得到內建的 pcode_all.json 資料檔。

其他 MCP 相容 client

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

.venv/bin/python -m mcp_server.server

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

疑難排解

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

playwright._impl._errors.Error: Executable doesn't exist
→ 你跳過了 Quick Start 步驟 3。執行 .venv/bin/playwright install chromium。只有 search_judgments 用 keyword（全文）時需要這個；案號查詢是純 HTTP，不用 Playwright 也能跑。

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 步驟 4 的驗證指令。若失敗，代表 import chain 壞了 — 看 traceback。若通過，問題在 MCP client 的啟動設定（路徑或 cwd 錯了）。

第一次查詢很慢
→ 啟動時伺服器會在背景延遲啟動 Playwright（~12 秒）。第一次 search_judgments 關鍵字查詢若 warmup 還沒完成可能會卡一下。後續查詢會很快。

資料來源

所有資料都取自台灣政府公開資料庫。不會對外做其他網路呼叫：

• judgment.judicial.gov.tw — 司法院裁判書系統
• data.judicial.gov.tw — 司法院開放資料 API
• law.moj.gov.tw — 法務部全國法規資料庫

mcp_server/config.py:ALLOWED_DOMAINS 以硬編碼 allow-list 強制執行。伺服器會拒絕抓取任何不在這些網域的 URL。

快取

全部清除：刪掉 mcp_server/data/cache/legal_mcp.db。快取檔在 .gitignore 內。

pcode_all.json 自動更新

伺服器啟動時會檢查 mcp_server/data/pcode_all.json 的時間戳。如果最後一次更新在最近的週六之前，會在背景觸發從 law.moj.gov.tw 官方 API 重新抓取。失敗會記為 warning，不會阻擋啟動。

手動更新：

.venv/bin/python -m mcp_server.updater

專案結構

mcp-taiwan-legal-db/
├── .gitignore
├── .mcp.json              # 資料夾內 Claude Code session 自動註冊用
├── LICENSE                # MIT
├── README.md              # 本檔（繁體中文）
├── README.en.md           # English version
├── pyproject.toml         # 套件 metadata 與相依
└── mcp_server/
    ├── __init__.py
    ├── server.py          # FastMCP 入口 — 定義 5 個 @mcp.tool() function
    ├── config.py          # URL、法院代碼、快取 TTL、allowed domains
    ├── updater.py         # 獨立的 pcode_all.json 更新 script
    ├── cache/db.py        # SQLite 快取層
    ├── data/
    │   ├── pcode_all.json          # 11,700+ 部法規（內建，~780 KB）
    │   └── law_histories.json      # 修法沿革（內建，~9.6 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
    └── tests/             # pytest 測試

執行測試

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

關於

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

• 官網：lawchat.com.tw
• 聯絡：[email protected]
• 回報問題：GitHub Issues

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

License

MIT

免責聲明

This is an unofficial tool for querying publicly-available Taiwan legal databases. It is not affiliated with, endorsed by, or authorized by the Judicial Yuan, the Ministry of Justice, or any Taiwan government agency.

The data returned by this tool reflects the state of the upstream official sources at the time of query. It may be cached (see TTLs above), and must not be treated as legal advice or a substitute for the authoritative official sources. Always verify against the original sources before relying on the data for any legal or official purpose.

本工具為非官方的台灣公開法規資料查詢工具，與司法院、法務部或任何台灣政府機關無隸屬關係。查詢結果以上游官方資料庫當下狀態為準（且可能被快取 — 見上方 TTL 表），不得作為法律意見或正式用途依據，使用前請向官方資料庫驗證。