mcp-taiwan-legal-db

English · 繁體中文

台灣法規、裁判書、憲法法庭裁判 — MCP Server。

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

• 司法院裁判書 — judgment.judicial.gov.tw（全文搜尋 + 取得）
• 全國法規資料庫 — law.moj.gov.tw（11,700+ 部法規）
• 憲法法庭 — cons.judicial.gov.tw（868 筆大法官解釋 + 憲判字，含理由書全文，離線快取）

以 Python 搭配 FastMCP 寫成。純工具 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

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

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

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

選擇性 — F5 WAF fallback：

playwright install chromium    # 僅在司法院 WAF 觸發時用，平時 idle

開發環境設置

下面是 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（僅在司法院 WAF 觸發時使用，一般查詢不會啟動）
.venv/bin/playwright install chromium

# 4. 驗證伺服器可以啟動並註冊 8 個工具
.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) == 8, f'Expected 8 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']
✓ Setup OK

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

有什麼工具可以用

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

法規與裁判

憲法法庭

工具細節

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

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

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