Korean Law Search
Search and retrieve Korean statutes and administrative rules with precise filters. Access English translations and drill down to articles, paragraphs, and sub-items. Explore linkages with local ordinances and delegated authority to speed up legal research.
Ask AI about Korean Law Search
Powered by Claude Β· Grounded in docs
I know everything about Korean Law Search. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
LexLink - Korean National Law Information MCP Server
π Read this in other languages: English | νκ΅μ΄ (Korean)
LexLink is an MCP (Model Context Protocol) server that exposes the Korean National Law Information API (open.law.go.kr) to AI agents and LLM applications. It enables AI systems to search, retrieve, and analyze Korean legal information through standardized MCP tools.
Features
- 54 MCP Tools + 2 MCP Resources for comprehensive Korean law information access
- Search and retrieve Korean laws (effective date & announcement date)
- Search and retrieve English-translated laws
- Search and retrieve administrative rules (νμ κ·μΉ)
- Query specific articles, paragraphs, and sub-items
- Law-ordinance linkage (λ²λ Ή-μμΉλ²κ· μ°κ³)
- Delegated law information (μμλ²λ Ή)
- Phase 3 - Case Law & Legal Research
- Court precedents (νλ‘)
- Constitutional Court decisions (νμ¬κ²°μ λ‘)
- Legal interpretations (λ²λ Ήν΄μλ‘)
- Administrative appeal decisions (νμ μ¬νλ‘)
- Phase 4 - Article Citation Extraction
- Extract legal citations from any law article (100% accuracy)
- NEW: Phase 5 - AI-Powered Search
- Semantic search for natural language queries (aiSearch)
- Related laws discovery (aiRltLs_search)
- MCP Resources - Law ID Cache
- Cached mapping of ~20 frequently-used law names to stable λ²λ ΉID codes
- Template lookup by Korean name or abbreviation (
lexlink://law/{name}) - Dynamic caching: search results automatically populate the cache
- Smart Features (inspired by korean-law-mcp):
- Intelligent Caching - Per-tool TTL caching (search 1hr, articles 24hr, AI search 30min)
- Law Name Resolution - Auto-resolves Korean abbreviations (μν΅λ²βμλ³Έμμ₯κ³Ό κΈμ΅ν¬μμ μ κ΄ν λ²λ₯ ), 52 seed aliases + dynamic learning
- Chain Tools - Multi-step research workflows in one call (Phase 9)
- 100% Semantic Validation - All Phase 1-5 tools confirmed returning real law data
- Error Handling - Actionable error messages with resolution hints
- Korean Text Support - Proper UTF-8 encoding for Korean characters
- Response Formats - JSON (default), HTML, or XML (multiple formats supported)
Project Status
π Production Ready - Phase 9 Complete!
| Metric | Status |
|---|---|
| Tools Implemented | 54/54 (100%) β |
| Semantic Validation | 26/26 (Phase 1-5 tools) β |
| MCP Prompts | 9/9 (100%) β |
| MCP Resources | 2 (1 static + 1 template) β |
| API Coverage | ~28% of 191+ endpoints |
| LLM Integration | β Validated (Gemini) |
| Code Quality | Clean, documented, tested |
| Version | v2.1.0 |
Latest: v2.1.0 β 54 tools (Phase 9 added), intelligent caching (cache.py), law name resolution (resolver.py), chain tools for multi-step research workflows.
Prerequisites
- Python 3.10+
- law.go.kr OC identifier: Register at open.law.go.kr
Quick Start
1. Install Dependencies
uv sync
2. Configure Your OC Identifier
Option A: Environment Variable (Recommended)
# Set OC in your environment
export OC=your_id_here
Option B: Pass in Tool Arguments
# Override OC in each tool call
eflaw_search(query="λ²λ Ήλͺ
", oc="your_id")
3. Run the Server
# Stdio transport (for Claude Code, Cursor, etc.)
OC=your_oc uv run stdio
# HTTP transport (for Kakao PlayMCP)
OC=your_oc TRANSPORT=http uv run serve
Available Tools
Phase 1: Core Law APIs (6 tools)
1. eflaw_search - Search Laws by Effective Date
Search for laws organized by effective date (μνμΌ κΈ°μ€).
eflaw_search(
query="μλμ°¨κ΄λ¦¬λ²", # Search keyword
display=10, # Results per page
type="XML", # Response format
ef_yd="20240101~20241231" # Optional date range
)
2. law_search - Search Laws by Announcement Date
Search for laws organized by announcement date (곡ν¬μΌ κΈ°μ€).
law_search(
query="λ―Όλ²",
display=10,
type="XML"
)
3. eflaw_service - Retrieve Law Content (Effective Date)
Get full law text and articles by effective date.
IMPORTANT: For specific article queries (e.g., "μ 174μ‘°"), use the
joparameter. Some laws have 400+ articles and responses can exceed 1MB withoutjo.
# Get specific article (RECOMMENDED)
eflaw_service(
mst="279823", # Law MST
jo="017400", # Article 174 (μ 174μ‘°)
type="XML"
)
# Get full law (WARNING: large response)
eflaw_service(
id="001823",
type="XML"
)
4. law_service - Retrieve Law Content (Announcement Date)
Get full law text and articles by announcement date.
IMPORTANT: For specific article queries (e.g., "μ 174μ‘°"), use the
joparameter. Some laws have 400+ articles and responses can exceed 1MB withoutjo.
# Get specific article (RECOMMENDED)
law_service(
mst="279823", # Law MST
jo="017400", # Article 174 (μ 174μ‘°)
type="XML"
)
5. eflaw_josub - Query Article/Paragraph (Effective Date)
Best tool for querying specific articles. Returns only the requested article/paragraph.
eflaw_josub(
mst="279823", # Law MST
jo="017400", # Article 174 (μ 174μ‘°)
type="XML"
)
# jo format: "XXXXXX" where first 4 digits = article (zero-padded), last 2 = branch (00=main)
# Examples: "017400" (μ 174μ‘°), "000300" (μ 3μ‘°), "001502" (μ 15μ‘°μ2)
6. law_josub - Query Article/Paragraph (Announcement Date)
Best tool for querying specific articles. Returns only the requested article/paragraph.
law_josub(
mst="279823", # Law MST
jo="017200", # Article 172 (μ 172μ‘°)
type="XML"
)
Phase 2: Extended APIs (9 tools)
7. elaw_search - Search English-Translated Laws
Search for Korean laws translated to English.
elaw_search(
query="employment",
display=10,
type="XML"
)
8. elaw_service - Retrieve English Law Content
Get full English-translated law text.
elaw_service(
id="009589",
type="XML"
)
9. admrul_search - Search Administrative Rules
Search administrative rules (νλ Ή, μκ·, κ³ μ, κ³΅κ³ , μ§μΉ¨).
admrul_search(
query="νκ΅",
display=10,
type="XML"
)
10. admrul_service - Retrieve Administrative Rule Content
Get full administrative rule text with annexes.
admrul_service(
id="62505",
type="XML"
)
11. lnkLs_search - Search Law-Ordinance Linkage
Find laws linked to local ordinances.
lnkLs_search(
query="건μΆ",
display=10,
type="XML"
)
12. lnkLsOrdJo_search - Search Ordinance Articles by Law
Find ordinance articles linked to specific law articles.
lnkLsOrdJo_search(
knd="002118", # Law ID
display=10,
type="XML"
)
13. lnkDep_search - Search Law-Ordinance Links by Ministry
Find laws linked to ordinances by government ministry.
lnkDep_search(
org="1400000", # Ministry code
display=10,
type="XML"
)
14. drlaw_search - Retrieve Law-Ordinance Linkage Statistics
Get linkage statistics table (HTML format).
drlaw_search(
lid="001823", # Law ID
type="HTML"
)
15. lsDelegated_service - Retrieve Delegated Law Information
Get information about delegated laws, rules, and ordinances.
lsDelegated_service(
id="001823",
type="XML"
)
Phase 3: Case Law & Legal Research (8 tools - NEW!)
Tip: All
*_servicetools in Phase 3 support asections="summary"parameter to return only a brief summary instead of the full document text.
16. prec_search - Search Court Precedents
Search Korean court precedents from Supreme Court and lower courts.
prec_search(
query="λ΄λ³΄κΆ",
display=10,
type="XML",
curt="λλ²μ" # Optional: Court name filter
)
17. prec_service - Retrieve Court Precedent Full Text
Get complete court precedent text with case details.
prec_service(
id="228541",
type="XML"
)
18. detc_search - Search Constitutional Court Decisions
Search Korean Constitutional Court decisions.
detc_search(
query="λ²κΈ",
display=10,
type="XML"
)
19. detc_service - Retrieve Constitutional Court Decision Full Text
Get complete Constitutional Court decision text.
detc_service(
id="58386",
type="XML"
)
20. expc_search - Search Legal Interpretations
Search legal interpretation precedents issued by government agencies.
expc_search(
query="μμ°¨",
display=10,
type="XML"
)
21. expc_service - Retrieve Legal Interpretation Full Text
Get complete legal interpretation text.
expc_service(
id="334617",
type="XML"
)
22. decc_search - Search Administrative Appeal Decisions
Search Korean administrative appeal decisions.
decc_search(
query="*", # Search all decisions
display=10,
type="XML"
)
23. decc_service - Retrieve Administrative Appeal Decision Full Text
Get complete administrative appeal decision text.
decc_service(
id="243263",
type="XML"
)
Phase 4: Article Citation Extraction (1 tool - NEW!)
24. article_citation - Extract Citations from Law Article
Extract all legal citations referenced by a specific law article.
# First, search for the law to get MST
eflaw_search(query="건μΆλ²") # Returns MST: 268611
# Then extract citations
article_citation(
mst="268611", # Law MST from search result
law_name="건μΆλ²", # Law name
article=3 # Article number (μ 3μ‘°)
)
Response:
{
"success": true,
"law_name": "건μΆλ²",
"article": "μ 3μ‘°",
"citation_count": 12,
"internal_count": 4,
"external_count": 8,
"citations": [
{
"type": "external",
"target_law_name": "γκ΅ν μ κ³ν λ° μ΄μ©μ κ΄ν λ²λ₯ γ",
"target_article": 56,
"target_paragraph": 1
}
]
}
Key Features:
- 100% accuracy via HTML parsing (not LLM-based)
- Zero API cost (no external LLM calls)
- ~350ms average extraction time
- Distinguishes internal vs external citations
Phase 5: AI-Powered Search (2 tools - NEW!)
25. aiSearch - AI-Powered Semantic Law Search
β PREFERRED TOOL for vague or natural language queries. Use this FIRST when user's intent is unclear or conversational.
Uses intelligent/semantic search to find relevant law articles with full article text.
aiSearch(
query="λΊμλ μ²λ²", # Natural language query
search=0, # 0: law articles, 1: appendix, 2: admin rules, 3: admin appendix
display=20, # Results per page
page=1, # Page number
type="JSON" # Response format (JSON default)
)
Best for: Natural language queries like "μμ£Όμ΄μ λ²κΈ", "μ΄νΌ μ¬μ°λΆν ", "μμ λ¬Έμ "
26. aiRltLs_search - AI-Powered Related Laws Search
β PREFERRED TOOL for discovering related laws from vague topics. Use this when user wants to explore laws around a general subject.
Finds laws semantically related to a given law name or keyword.
aiRltLs_search(
query="λ―Όλ²", # Law name or keyword
search=0, # 0: law articles, 1: admin rule articles
type="JSON" # Response format (JSON default)
)
Best for: Finding related laws like "λ―Όλ²" β μλ², μλ£λ², μμ‘μ΄μ§λ²
Phase 7: Extended Legal Information (18 tools)
| Category | Tools |
|---|---|
| μμΉλ²κ· (Local Ordinances) | ordin_search, ordin_service, ordinLsCon_search |
| μ‘°μ½ (Treaties) | trty_search, trty_service |
| λ²λ Ήμ 보 μ§μλ² μ΄μ€ (Knowledge Base) | lstrm_ai_search, dlytrm_search, lstrm_rlt_search, dlytrm_rlt_search, lstrm_rlt_jo_search, jo_rlt_lstrm_search, ls_rlt_search |
| μμν κ²°μ λ¬Έ (Committee Decisions) | committee_search, committee_service |
| μ€μλΆμ² 1μ°¨ ν΄μ (Ministry Interpretations) | cgm_expc_search, cgm_expc_service |
| νΉλ³νμ μ¬ν (Special Appeals) | special_decc_search, special_decc_service |
Phase 9: Chain Tools (5 tools)
Inspired by korean-law-mcp, these tools run multi-step research workflows in a single call β eliminating the need for an LLM to orchestrate sequential tool calls manually.
| Tool | Description |
|---|---|
chain_full_research | Complete legal research: statutes + precedent analysis + interpretations |
chain_amendment_track | Revision history + article-level diff across amendments |
chain_dispute_prep | All case law sources across 4 databases (νλ‘, νμ¬κ²°μ λ‘, λ²λ Ήν΄μλ‘, νμ μ¬νλ‘) |
chain_law_system | Full law hierarchy: delegation tree + admin rules + ordinances |
cache_stats | Cache and resolver performance monitoring |
Tool Selection Guide
When searching Korean law, select tools based on query clarity:
| Query Type | Recommended Tools | Examples |
|---|---|---|
| π Vague/Natural language | aiSearch, aiRltLs_search | "μμ£Όμ΄μ μ²λ²", "μ΄νΌ μ¬μ°λΆν " |
| π Specific law/article | eflaw_search, law_search | "νλ² μ 148μ‘°μ2", "λ―Όλ² μμνΈ" |
| βοΈ Case law | prec_search, detc_search | "λλ²μ 2023λ€12345" |
| π Related laws | aiRltLs_search | "λ―Όλ²κ³Ό κ΄λ ¨λ λ²λ₯ " |
Configuration
Environment Variables
| Variable | Default | Description |
|---|---|---|
OC | (required) | law.go.kr API identifier (email local part) |
LEXLINK_BASE_URL | http://www.law.go.kr | API base URL |
LEXLINK_TIMEOUT | 60 | HTTP request timeout in seconds |
SLIM_RESPONSE | (unset) | Set true to remove redundant raw XML when parsed data exists (for PlayMCP) |
TRANSPORT | sse | Transport type: sse or http |
OC Priority
When resolving the OC identifier:
- Tool argument (highest priority) -
ocparameter in tool call - Environment variable -
OCenv var (set via .env or HTTP header middleware)
Usage Examples
Example 1: Basic Search
# Search for automobile management law
result = eflaw_search(
query="μλμ°¨κ΄λ¦¬λ²",
display=5,
type="XML"
)
# Returns:
{
"status": "ok",
"request_id": "uuid",
"upstream_type": "XML",
"data": {
# Law search results...
}
}
Example 2: Search with Date Range
# Find laws effective in 2024
result = eflaw_search(
query="κ΅ν΅",
ef_yd="20240101~20241231",
type="XML"
)
Example 3: Error Handling
# Missing OC parameter
result = eflaw_search(query="test")
# Returns helpful error:
{
"status": "error",
"error_code": "MISSING_OC",
"message": "OC parameter is required but not provided.",
"hints": [
"1. Tool argument: oc='your_value'",
"2. Environment variable: OC=your_value"
]
}
Golden MCP Tool Trajectories
These examples demonstrate real-world conversation flows showing how LLMs interact with LexLink tools to answer legal research questions.
Trajectory 1: Basic Law Research
User Query: "What is Article 20 of the Civil Code?"
Tool Calls:
law_search(query="λ―Όλ²", display=50, type="XML")β Find Civil Code IDlaw_service(id="000021", jo="002000", type="XML")β Retrieve Article 20 text
Result: LLM provides formatted explanation of Civil Code Article 20 with full legal text and context.
Trajectory 2: Court Precedent Analysis
User Query: "Find recent Supreme Court precedents about security interests"
Tool Calls:
prec_search(query="λ΄λ³΄κΆ", curt="λλ²μ", display=50, type="XML")β Search Supreme Court precedentsprec_service(id="228541", type="XML")β Retrieve top precedent details
Result: LLM summarizes key precedents with case numbers, dates, and holdings related to security interests.
Trajectory 3: Cross-Phase Legal Research
User Query: "How does the Labor Standards Act handle overtime, and are there relevant court precedents?"
Tool Calls:
eflaw_search(query="κ·Όλ‘κΈ°μ€λ²", display=50, type="XML")β Find Labor Standards Acteflaw_service(id="001234", jo="005000", type="XML")β Retrieve Article 50 (overtime provisions)prec_search(query="κ·Όλ‘κΈ°μ€λ² μ°μ₯κ·Όλ‘", display=30, type="XML")β Search overtime precedentsprec_service(id="234567", type="XML")β Retrieve leading precedent
Result: LLM provides comprehensive analysis combining statutory text with judicial interpretation, showing how courts apply the overtime provisions.
Trajectory 4: Constitutional Review
User Query: "Has the Constitutional Court reviewed laws about fines?"
Tool Calls:
detc_search(query="λ²κΈ", display=50, type="XML")β Search Constitutional Court decisionsdetc_service(id="58386", type="XML")β Retrieve decision full textlaw_search(query=<law_name_from_decision>, type="XML")β Find related law for context
Result: LLM explains Constitutional Court holdings on fine-related provisions and their impact on specific laws.
Trajectory 5: Administrative Law Research
User Query: "What administrative rules exist for schools, and are there related legal interpretations?"
Tool Calls:
admrul_search(query="νκ΅", display=50, type="XML")β Search school-related administrative rulesadmrul_service(id="62505", type="XML")β Retrieve rule contentexpc_search(query="νκ΅", display=30, type="XML")β Search legal interpretationsexpc_service(id="334617", type="XML")β Retrieve interpretation details
Result: LLM provides overview of administrative framework for schools with official agency interpretations.
Trajectory 6: Comprehensive Legal Analysis
User Query: "I'm researching rental housing disputes. Show me the relevant law, court precedents, and administrative appeal decisions."
Tool Calls:
eflaw_search(query="μ£Όνμλ차보νΈλ²", display=50, type="XML")β Find Housing Lease Protection Acteflaw_service(id="002876", type="XML")β Retrieve full law textprec_search(query="μ£Όνμλμ°¨", display=50, type="XML")β Search housing lease precedentsprec_service(id="156789", type="XML")β Retrieve key precedentdecc_search(query="μ£Όνμλμ°¨", display=30, type="XML")β Search administrative appeal decisionsdecc_service(id="243263", type="XML")β Retrieve appeal decision
Result: LLM provides comprehensive legal research report covering statutory framework, judicial interpretation, and administrative precedents for rental housing disputes.
Trajectory 7: Citation Network Analysis (Phase 4)
User Query: "What laws does Article 3 of the Building Act cite?"
Tool Calls:
eflaw_search(query="건μΆλ²", display=50, type="XML")β Find Building Act, get MSTarticle_citation(mst="268611", law_name="건μΆλ²", article=3)β Extract all citations
Result: LLM provides complete citation analysis showing 12 citations (8 external laws, 4 internal references) including specific article and paragraph references.
Trajectory 8: AI-Powered Natural Language Search (Phase 5)
User Query: "What's the penalty for hit-and-run accidents?"
Tool Calls:
aiSearch(query="λΊμλ μ²λ²", search=0, display=20, type="XML")β Semantic search for hit-and-run penalties
Result: LLM receives full article text from relevant laws (νΉμ λ²μ£ κ°μ€μ²λ² λ±μ κ΄ν λ²λ₯ μ 5μ‘°μ3) with complete provisions about hit-and-run penalties, enabling comprehensive answer without needing to know specific law names.
Trajectory 9: Discovering Related Laws (Phase 5)
User Query: "What laws are related to the Civil Code?"
Tool Calls:
aiRltLs_search(query="λ―Όλ²", search=0, type="XML")β Find semantically related laws
Result: LLM discovers related laws like μλ² (Commercial Act), μλ£λ² (Medical Service Act), μμ‘μ΄μ§λ² (Act on Special Cases Concerning Expedition of Litigation), showing connections across legal domains.
Key Patterns
- AI Tools for Vague Queries: Use
aiSearchoraiRltLs_searchFIRST when user intent is unclear or conversational - Search First, Then Retrieve: Always search to find IDs before calling service tools
- Use display=50-100 for Law Searches: Ensures exact matches are found due to relevance ranking
- Combine Phases: Mix Phase 1 (laws), Phase 2 (administrative rules), Phase 3 (precedents), and Phase 5 (AI search) for complete research
- Type Parameter: Default is
type="JSON"; specifytype="XML"if your pipeline requires XML - Article Numbers: Use 6-digit format (e.g., "002000" for Article 20) when querying specific articles
Development
Project Structure
lexlink-ko-mcp/
βββ src/lexlink/
β βββ server.py # Main MCP server with 54 tools
β βββ _helpers.py # Shared helpers: run_search, run_service, TOOL_ANNOTATIONS
β βββ cache.py # Intelligent per-tool TTL caching (~183 lines)
β βββ resolver.py # Korean law name/abbreviation resolution (~225 lines)
β βββ http_server.py # HTTP/SSE server for Kakao PlayMCP
β βββ stdio_server.py # Stdio transport entry point
β βββ params.py # Parameter resolution & mapping
β βββ validation.py # Input validation
β βββ parser.py # XML parsing utilities
β βββ ranking.py # Relevance ranking
β βββ citation.py # Article citation extraction (Phase 4)
β βββ client.py # HTTP client for law.go.kr API
β βββ errors.py # Error codes & responses
β βββ raw_logger.py # PlayMCP traffic logging
β βββ log_processor.py # Log format converter
βββ logs/playmcp/ # PlayMCP traffic logs (daily JSONL)
βββ pyproject.toml # Project configuration
βββ README.md # This file
Running Tests
# Install test dependencies
uv sync
# Run all tests
uv run pytest
# Run with coverage
uv run pytest --cov=src/lexlink --cov-report=html
# Run specific test category
uv run pytest -m unit
uv run pytest -m integration
uv run pytest -m e2e
Adding New Tools
Current Status: 54/54 tools implemented (Phase 1-9 complete). Phase 1-5 tools validated.
For implementing additional tools from the 124+ remaining APIs:
- Follow the pattern established in
src/lexlink/server.py - Use
ctx: Context = Noneparameter for MCP logging/progress - Use generic parser functions (
extract_items_list,update_items_list) - Add semantic validation tests
Tool Implementation Pattern:
- Each tool is a decorated function with MCP schema
- Uses
ctx: Context = Noneparameter for MCP context - 2-tier OC resolution: tool arg > env var
- Generic parser functions work with any XML tag
- Comprehensive error handling with actionable hints
Deployment
Deploy to Kakao PlayMCP (HTTP Server)
LexLink can also be deployed as an HTTP server for platforms like Kakao PlayMCP.
Important: Kakao PlayMCP does not accept port numbers in URLs. You must use Nginx as a reverse proxy to serve on port 80.
Quick Start (Local Testing):
# Run the HTTP server
OC=your_oc uv run serve
# Server starts at: http://localhost:8000/sse
Production Setup:
Internet β Nginx (port 80) β LexLink (port 8000)
PlayMCP Registration:
| Field | Value |
|---|---|
| MCP Endpoint | http://YOUR_SERVER_IP/sse (no port!) |
| Authentication | Key/Token (Header: OC) |
For detailed deployment instructions (AWS EC2, Nginx, systemd, HTTPS), see docs/DEPLOYMENT_GUIDE.md.
PlayMCP Traffic Logging
LexLink includes built-in logging for PlayMCP traffic analysis. Logs are saved in dashboard-compatible JSONL format.
Log Location: logs/playmcp/YYYY-MM-DD.jsonl
Log Schema:
{
"rpc_id": "3",
"request_id": "d8ee45eb",
"session_id": "9ff9dc23431848a4901b4cb6326ba5bd",
"timestamp": "2025-12-25T05:40:23.957987",
"duration_ms": 1.52,
"method": "tools/call",
"tool_name": "aiSearch",
"params": { "arguments": {"query": "λΊμλ μ²λ²"} },
"client": "PlayMCP",
"client_version": "2025.0.0",
"protocol_version": "2025-06-18",
"client_ip": "220.64.111.219",
"oc": "user_id",
"status": "success",
"status_code": 200,
"result": { ... }
}
Features:
- Daily log rotation (one file per day)
- Dashboard-compatible format for filtering and analysis
- Captures request/response pairs with timing
- SSE streaming response parsing
Converting Old Raw Logs:
uv run python -m lexlink.log_processor input.jsonl output.jsonl
Troubleshooting
"OC parameter is required" error
Solution: Set your OC identifier using one of the three methods above.
Korean characters not displaying correctly
Solution: Ensure your terminal supports UTF-8:
export PYTHONIOENCODING=utf-8
"Timeout" errors
Solution: Increase timeout via environment variable:
export LEXLINK_TIMEOUT=90 # Increase from default 60s
Server won't start after updating dependencies
Solution: Re-sync dependencies:
uv sync --reinstall
Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Write tests for new functionality
- Ensure all tests pass (
uv run pytest) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is open source. See LICENSE file for details.
Acknowledgments
- law.go.kr - Korean National Law Information API
- MCP - Model Context Protocol by Anthropic
- korean-law-mcp - Inspiration for caching, law name resolution, and chain tools (Phase 9)
Support
- Issues: GitHub Issues
- law.go.kr API: Official Documentation
Changelog
v2.1.0 - 2026-03-30
New: Caching, Law Name Resolution, Chain Tools (Phase 9)
- Added intelligent per-tool TTL caching (
cache.py): search 1hr, articles 24hr, AI search 30min - Added law name/abbreviation resolution (
resolver.py): 52 seed aliases + dynamic learning - Added 5 Phase 9 chain tools:
chain_full_research,chain_amendment_track,chain_dispute_prep,chain_law_system,cache_stats - Inspired by korean-law-mcp
- See CHANGELOG.md for full details
v2.0.0 - 2026-03-30
Major Release: Phase 7 Tools, JSON Default, sections Parameter
- Added 18 new Phase 7 tools (μμΉλ²κ·, μ‘°μ½, λ²λ Ήμ 보 μ§μλ² μ΄μ€, μμν κ²°μ λ¬Έ, μ€μλΆμ² ν΄μ, νΉλ³νμ μ¬ν)
- JSON is now the default response format (was XML)
- Added
sections="summary"parameter for case law service tools - Refactored shared logic into
_helpers.py - See CHANGELOG.md for full details
v1.5.0 - 2026-02-28
Refactor: Remove Smithery Dependency
- Removed
smitherypackage and 8 transitive dependencies - Simplified OC resolution to 2-tier (tool arg > env var)
- Added
stdio_server.pyentry point for stdio transport - See CHANGELOG.md for full details
For the full changelog (v1.0.0 β v2.1.0), see CHANGELOG.md.
Powered by MCP
