MCP Taiwan Judgment Search
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Taiwan Judgment Search 搜尋最近關於著作權的判決"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Taiwan Judgment Search
An MCP server for searching Taiwan judicial judgments, exposing AI-callable tools over Model Context Protocol (MCP).
Features
Four MCP tools — full-text search, full-document fetch by ID, PDF download, and legal-term lookup
stdio JSON-RPC 2.0 — standard MCP transport protocol
@mcp.tool()decorator — Pydantic-typed tool registrationTwo-step scraping — handles the judicial site's iframe-based result rendering
No-auth public endpoint — 司法院裁判書系統 is fully public; no API keys required
Pure HTML parser layer —
parser/is decoupled from HTTP and tested offline with saved fixtures
Related MCP server: aluris-caselibrary-mcp
Available Tools
Tool | Description |
| Full-text keyword search across all judicial judgments. Paginated 20 per page. Returns |
| Fetch the complete text and metadata of a single judgment by its |
| Look up a legal term in the 司法院裁判書用語辭典. Returns definitions for each applicable legal domain (民事、刑事、行政、家事). Optionally filter by |
| Return or download a judgment's PDF. When |
Requirements
Python
3.12+One of:
uv(recommended) orpip
Installation
Option 1 — uvx (no install, runs on demand)
uvx mcp-tw-judgmentOption 2 — pip / uv pip
pip install mcp-tw-judgment
# or
uv pip install mcp-tw-judgmentAfter install, the mcp-tw-judgment console script is available.
Option 3 — From source
git clone https://github.com/asgard-ai-platform/mcp-tw-judgment.git
cd mcp-tw-judgment
uv sync
uv run mcp-tw-judgmentUsage
The server speaks MCP over stdio. Add it to your client of choice:
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"tw-judgment": {
"command": "uvx",
"args": ["mcp-tw-judgment"]
}
}
}Claude Code
Add to your project's .mcp.json:
{
"mcpServers": {
"tw-judgment": {
"command": "uvx",
"args": ["mcp-tw-judgment"]
}
}
}Cursor
~/.cursor/mcp.json:
{
"mcpServers": {
"tw-judgment": {
"command": "uvx",
"args": ["mcp-tw-judgment"]
}
}
}Environment Variables
Variable | Effect |
| Default directory for |
MCP servers are launched by the MCP client (Claude Desktop, Claude Code, Cursor), not by your shell — exporting a variable in ~/.zshrc or ~/.bashrc will not reach the server. Set variables in the client config's env block:
{
"mcpServers": {
"tw-judgment": {
"command": "uvx",
"args": ["mcp-tw-judgment"],
"env": {
"MCP_TW_JUDGMENT_DOWNLOAD_DIR": "~/Downloads/tw-judgments"
}
}
}
}Apply this to whichever client config you use (claude_desktop_config.json, .mcp.json, or ~/.cursor/mcp.json). Restart the client after editing.
Example Tool Usage
You: 最近有哪些和著作權有關的判決
AI call: tw-judgment - search_judgments (MCP)(keyword: "著作權")
{
"keyword": "著作權",
"total": 55265,
...
}Result: 以下是最近的著作權相關判決(共 55,265 筆,以下列出最新 10 件核心案件):
115.04.15 │ 智慧財產及商業法院 │ 114年民著訴52 │ 侵害著作權有關人格權爭議
...You: 請告訴我 114年民著訴52 的詳細資訊
AI call: tw-judgment - get_judgment (MCP)(judgment_id: "IPCV,114,民著訴,52,20260415,1")
{
"title": "智慧財產及商業法院 114 年度民著訴字第 52 號民事判決",
"date": "民國 115 年 04 月 15 日",
"case_reason": "侵害著作權有關人格權爭議",
"content": "……全文字串……",
"paragraphs": [
{"id": "主文", "section": "主文", "level": 1, "heading": null, "text": "……"},
{"id": "事實及理由.一", "section": "事實及理由", "level": 2, "heading": "原告主張:", "text": ""},
{"id": "事實及理由.一.(一)", "section": "事實及理由", "level": 3, "heading": null, "text": "……"},
...
]
}Result: 本件爭點為…(AI 會直接引用 事實及理由.一.(一) 這段)
You: 把這份判決的 PDF 抓下來放桌面,我要附在書狀證物裡
AI call: tw-judgment - get_judgment_pdf (MCP)(judgment_id: "IPCV,114,民著訴,52,20260415,1", save_to: "~/Desktop")
{
"judgment_id": "IPCV,114,民著訴,52,20260415,1",
"url": "https://judgment.judicial.gov.tw/FILES/IPCV/114%2c%e6%b0%91%e8%91%97%e8%a8%b4%2c52%2c20260415%2c1.pdf",
"path": "/Users/you/Desktop/IPCV,114,民著訴,52,20260415,1.pdf",
"size_bytes": 245678,
"cached": false
}Result: 已下載到 ~/Desktop/IPCV,114,民著訴,52,20260415,1.pdf。
Tip: Set
MCP_TW_JUDGMENT_DOWNLOAD_DIR=~/Downloads/tw-judgmentsto have every call download to that folder by default; omitsave_toin the call and the tool returns the URL only (no download).
Project Structure
mcp-tw-judgment/
├── app.py # FastMCP singleton
├── mcp_server.py # Entry point (stdio transport)
├── config/settings.py # API base URL, endpoints, request headers
├── connectors/rest_client.py # HTTP GET helper with retry + encoding detection
├── auth/none.py # No-op auth module (public endpoint)
├── parser/
│ ├── judgment_parser.py # Pure HTML parsers for judgments (no HTTP)
│ └── terms_parser.py # Pure HTML parsers for 用語辭典 (no HTTP)
├── tools/judgment_tools.py # MCP tool definitions
├── tests/
│ ├── fixtures/ # Saved HTML responses for offline unit tests
│ ├── test_judgment_parser.py # Unit tests (no network)
│ ├── test_terms_parser.py # Unit tests for terms parser (no network)
│ └── test_all_tools.py # Tool tests (live API, opt-in via RUN_LIVE_TESTS=1)
└── scripts/auth/test_connection.pyDevelopment
# Setup
uv sync
# Connection check
uv run python scripts/auth/test_connection.py
# Run server locally
uv run mcp-tw-judgment
# Offline tests (parser + tool registration)
uv run python -m unittest tests.test_judgment_parser tests.test_all_tools -v
# Live API tests (hits 司法院 endpoint)
RUN_LIVE_TESTS=1 uv run python -m unittest tests.test_all_tools -vSee CONTRIBUTING.md for adding new tools.
License
MIT License — see LICENSE for details.
Data Source & Disclaimer
This project directly scrapes the 司法院裁判書系統 public search interface — this is not an official API.
Please note: This tool is intended for personal research and ad-hoc queries only. Do not use it for bulk automated access or scraping, as this may place undue load on the judicial system's servers. Use at your own discretion and in accordance with the website's terms of use.
Available Tools
4 toolsget_judgmentA
取得單一裁判書的完整內容,包含案件資訊與全文。
Inputs: judgment_id (required).
get_judgment_pdfA
取得裁判書 PDF 連結,可選擇直接下載到本機。
回傳 dict 一定包含 judgment_id 與 url;當實際下載時另含 path、size_bytes、cached。
Inputs: judgment_id (required), save_to.
lookup_legal_termA
查詢司法院裁判書用語辭典,取得法律名詞的定義與各法領域說明。
同一名詞可能有民事、刑事、行政、家事等不同法領域的解釋,均會一併回傳。 指定 domain 可篩選特定法領域的解釋。
Inputs: term (required), domain.
search_judgmentsA
搜尋司法院裁判書全文,回傳符合關鍵字的裁判書清單。
每筆結果包含 judgment_id(可傳入 get_judgment 取得全文)、標題、裁判日期、
案由、摘要片段。
Inputs: keyword (required), page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool serves a distinct purpose: retrieving full judgment text, getting PDF links, looking up legal terms, and searching judgments. No functional overlap.
All tool names follow a consistent verb_noun pattern in snake_case (get_judgment, get_judgment_pdf, lookup_legal_term, search_judgments), making them predictable.
With 4 tools covering search, retrieval, PDF download, and legal term lookup, the count is well-scoped for a judgment search server—neither too few nor too many.
The tool surface covers the complete workflow: search for judgments, retrieve full text or PDF, and look up legal terms. No obvious gaps for the intended domain.
Maintenance
Related MCP Connectors
Taiwan legal research MCP: 判決書、全國法規、釋字/憲判與立法歷程查詢,12 個工具,回應均附官方出處 URL。
Taiwan legal research MCP by Dr.Legal (法律偵探): 22.7M court judgments, current statutes, administrative rulings and Constitutional Court decisions. Retrieval-only, per-item citations, appeal-chain history, bundle-level citation audit. Free, no API key; OAuth 2.0 dynamic registration completes automatically. 台灣法律 MCP:2,272 萬筆裁判書、法規、函釋、憲法法庭裁判,逐筆附出處並提供引用查核。免費、免金鑰。Docs: https://dr-legal.com.tw/mcp
Taiwan legal research: court judgments, statutes, and interpretations. 台灣判決、法條、函釋、釋字搜尋。
Taiwan law, court decisions and agency regulations for your AI: statutes, rulings, read-only.
Related MCP Servers
- AlicenseAqualityAmaintenanceProvides AI assistants with access to Taiwan's public legal data, including court judgments, regulations, and constitutional court interpretations, via 8 MCP tools.26238 PyPI233MIT
- FlicenseAqualityCmaintenanceEnables semantic search and retrieval of Chinese judicial cases from the Supreme People's Court case library, supporting natural language queries for similar cases, case details, filtering, and statistics.810-
- AlicenseAqualityBmaintenanceEnables AI assistants to query Taiwan's legal databases including court judgments, regulations, constitutional interpretations, and engineering committee letters, with automatic updates and offline caching.13MIT
- FlicenseNot gradedqualityDmaintenanceProvides access to German court decisions and laws via MCP tools, enabling legal document search and retrieval.-