Korean Law MCP
korean-law-mcp
Installation
npx korean-law-mcpAsk AI about Korean Law MCP
Powered by Claude ยท Grounded in docs
I know everything about Korean Law MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
โ๏ธ ๋ํ๋ฏผ๊ตญ ๋ฒ๋ น/ํ๋ก ๊ฒ์๊ธฐ (Korean Law MCP)
"๋ฒ๋ฅ ์ ๋ณด๋ฅผ ๋๊ตฌ๋ ์ฝ๊ฒ."
์ด ํ๋ก๊ทธ๋จ์ ๋ณต์กํ ๋ํ๋ฏผ๊ตญ ๋ฒ๋ น๊ณผ ํ๋ก๋ฅผ ์ฑํ ํ๋ฏ์ด ์ฝ๊ฒ ๊ฒ์ํ๊ณ ์ฐพ์๋ณผ ์ ์๊ฒ ํด์ฃผ๋ ๋๊ตฌ์ ๋๋ค. Claude์ ๊ฐ์ AI์ ์ฐ๊ฒฐํ์ฌ ์ฌ์ฉํ ์ ์์ต๋๋ค.
๐ ์์ํ๊ธฐ (Quick Start)
๊ฐ์ฅ ์ฌ์ด ์ฌ์ฉ ๋ฐฉ๋ฒ์ ์๋ดํด ๋๋ฆฝ๋๋ค.
๋ฐฉ๋ฒ 1: uv๋ฅผ ์ด์ฉํ ์๋ ์ค์น (Mac/Linux/Windows ์ถ์ฒ)
uv๊ฐ ์ค์น๋์ด ์๋ค๋ฉด ๊ฐ์ฅ ๊ฐํธํ ๋ฐฉ๋ฒ์
๋๋ค. Claude ์ค์ ํ์ผ์ ์๋ ๋ด์ฉ์ ์ถ๊ฐํ์ธ์. (Python ๋ฑ์ ์ง์ ์ค์นํ ํ์๊ฐ ์์ต๋๋ค)
- ์ค์ ํ์ผ ๊ฒฝ๋ก:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- MacOS:
{
"mcpServers": {
"korean-law": {
"command": "uvx",
"args": [
"korean-law-mcp"
],
"env": {
"OPEN_LAW_ID": "์ฌ๊ธฐ์_์์ด๋๋ฅผ_๋ฃ์ผ์ธ์"
}
}
}
}
๋ฐฉ๋ฒ 2: ์๋์ฐ ์คํ ํ์ผ (์ค์น ๋ถํ์)
uv๋ Python ์ค์ ์ด ์ด๋ ค์ด ์๋์ฐ(Windows) ์ฌ์ฉ์๋ฅผ ์ํ ๋ฐฉ๋ฒ์
๋๋ค.
- ๋ค์ด๋ก๋ ํ์ด์ง(Releases)๋ก ์ด๋ํฉ๋๋ค.
- ์ต์ ๋ฒ์ ์
korean-law-mcp.exeํ์ผ์ ๋ค์ด๋ก๋ํฉ๋๋ค. - ๋ค์ด๋ก๋ํ ํ์ผ์ ๊ฒฝ๋ก๋ฅผ ๋ณต์ฌํด ๋ก๋๋ค. (์:
C:\Users\ํ๊ธธ๋\Downloads\korean-law-mcp.exe) - Claude Desktop ์ค์ ํ์ผ(
claude_desktop_config.json)์ ์ด๊ณ ์๋์ ๊ฐ์ด ์ ์ด์ฃผ์ธ์.
{
"mcpServers": {
"korean-law": {
"command": "C:\\Users\\ํ๊ธธ๋\\Downloads\\korean-law-mcp.exe",
"env": {
"OPEN_LAW_ID": "์ฌ๊ธฐ์_์์ด๋๋ฅผ_๋ฃ์ผ์ธ์"
}
}
}
}
๐ ํ์ ์ค๋น๋ฌผ: API ์์ด๋
์ด ํ๋ก๊ทธ๋จ์ ์ฌ์ฉํ๋ ค๋ฉด ๊ตญ๊ฐ๋ฒ๋ น์ ๋ณด์ผํฐ ์์ด๋๊ฐ ๊ผญ ํ์ํฉ๋๋ค.
- ๊ตญ๊ฐ๋ฒ๋ น์ ๋ณด์ผํฐ(law.go.kr)์ ์ ์ํ์ฌ ํ์๊ฐ์ ์ ํฉ๋๋ค.
- Open API ์ ์ฒญ ํ์ด์ง์์ '์ฌ์ฉ ์ ์ฒญ'์ ํฉ๋๋ค. (๋ฌด๋ฃ์ ๋๋ค)
- ๋ฐ๊ธ๋ฐ์ ์์ด๋๋ฅผ ์ค์ ํ์ผ์
"OPEN_LAW_ID"๋ถ๋ถ์ ๋ฃ์ด์ฃผ์ธ์.
โจ ์ฃผ์ ๊ธฐ๋ฅ
์ด ๋๊ตฌ๋ก ํ ์ ์๋ ๊ฒ๋ค์ ๋๋ค.
- ๐ ๋ฒ๋ น ๊ฒ์: "๊ณ ๋ฑ๊ต์ก๋ฒ ์ 20์กฐ ์ฐพ์์ค"๋ผ๊ณ ๋ฌผ์ด๋ณด๋ฉด ๋ฒ ์กฐํญ์ ๋ฐ๋ก ๋ณด์ฌ์ค๋๋ค.
- โ๏ธ ํ๋ก ์ฐพ๊ธฐ: "ํ๊ตํญ๋ ฅ ๊ด๋ จ ๋๋ฒ์ ํ๋ก ์ฐพ์์ค"๋ผ๊ณ ํ๋ฉด ๊ด๋ จ ํ๋ก๋ฅผ ์์ฝํด ์ค๋๋ค.
- ๐ ํ์ ๊ท์น/์์น๋ฒ๊ท: ํ๋ น, ์๊ท, ์ง์์ฒด ์กฐ๋ก๊น์ง ๋ชจ๋ ๊ฒ์ ๊ฐ๋ฅํฉ๋๋ค.
- ๐ ๋ฒ๋ น ์ฉ์ด: "๊ทผ๋ก์๊ฐ ๋ญ์ผ?"๋ผ๊ณ ๋ฌผ์ผ๋ฉด ๋ฒ์ ์ ์๋ฅผ ์ ํํ ์๋ ค์ค๋๋ค.
- ๐ค ๋ฒ๋ น ํด์๋ก: "์ด ๋ฒ์ ์ด๋ ๊ฒ ํด์ํด๋ ๋๋?" ๊ถ๊ธํ ๋ ๋ฒ์ ์ฒ์ ์ ๊ถํด์ ์ฌ๋ก๋ฅผ ์ฐพ์์ค๋๋ค.
- ๐ ์์/๋ณํ: ๋ฒ๋ น์ ์ฒจ๋ถ๋ ์์์ด๋ ํ๋ฅผ ๋ชฉ๋ก์ผ๋ก ๋ณด์ฌ์ค๋๋ค.
- ๐ ๋ฒ๋ฅ ๊ทธ๋ํ ํ์ (Deep Search):
explore_legal_chain๋๊ตฌ๋ฅผ ์ฌ์ฉํ๋ฉด "๊ณ ๋ฑ๊ต์ก๋ฒ ์ 20์กฐ" ๊ฒ์ ์ ์ํ๋ น/์ํ๊ท์น ๋ฑ ์์๋ ํ์ ๋ฒ๋ น๊ณผ ์ฐธ์กฐ๋ ๋ด/์ธ๋ถ ์กฐ๋ฌธ๊น์ง ํ ๋ฒ์ ์ฐพ์์ ์๋ฒฝํ ๋ณด๊ณ ์๋ฅผ ๋ง๋ค์ด์ค๋๋ค. - ๐ค ์ค๋งํธ ๊ฒ์: ๋ฒ๋ น ์ด๋ฆ์ ์ ํํ ๋ชฐ๋ผ๋, "๊น์๋๋ฒ"์ฒ๋ผ ํํ ๋ถ๋ฅด๋ ์ด๋ฆ์ผ๋ก ๊ฒ์ํด๋ ์์์ ์ฐพ์์ค๋๋ค.
๐ ๏ธ ์ฌ์ฉ ๊ฐ๋ฅํ ๋๊ตฌ (Reference)
์ด MCP ์๋ฒ๊ฐ ์ ๊ณตํ๋ ์ฃผ์ ๋๊ตฌ๋ค์ ์์ธ ์ค๋ช ์ ๋๋ค.
| ๋๊ตฌ ์ด๋ฆ | ์ค๋ช |
|---|---|
search_korean_law | (ํ์) ๋ฒ๋ น, ํ๋ก, ํ์ ๊ท์น์ ๊ฒ์ํ๋ ๊ฐ์ฅ ๊ธฐ๋ณธ ๋๊ตฌ์ ๋๋ค. "๋ฏผ๋ฒ ์ 103์กฐ" ์ฒ๋ผ ๊ตฌ์ฒด์ ์ผ๋ก ๊ฒ์ํ๋ฉด ๋ฐ๋ก ์กฐ๋ฌธ ๋ด์ฉ์ ๋ณด์ฌ์ค๋๋ค. |
read_legal_resource | statute:12345์ ๊ฐ์ ID๋ฅผ ์ฌ์ฉํ์ฌ ๋ฒ๋ น/ํ๋ก์ **์ ๋ฌธ(Full Text)**์ ๊ฐ์ ธ์ต๋๋ค. ๊ธด ๋ด์ฉ์ ๋ณผ ๋ ์ฌ์ฉํฉ๋๋ค. |
explore_legal_chain | Deep Search. ํน์ ์กฐ๋ฌธ๊ณผ ์ฐ๊ฒฐ๋ ํ์ ๋ฒ๋ น(์ํ๋ น/๊ท์น) ๋ฐ ์ฐธ์กฐ ์กฐ๋ฌธ์ ํ ๋ฒ์ ๋ชจ๋ ์ฐพ์ ๋ถ์ํฉ๋๋ค. |
get_statute_attachments | ๋ฒ๋ น์ ์ฒจ๋ถ๋ ๋ณํ๋ ์์ ํ์ผ์ ๋ชฉ๋ก์ ํ์ธํฉ๋๋ค. |
search_legal_terms | ๋ฒ๋ฅ ์ฉ์ด์ ์ ์๋ฅผ ์ฐพ์์ค๋๋ค. |
search_statutory_interpretations | ๋ฒ์ ์ฒ์ ๋ฒ๋ น ํด์ ์ฌ๋ก๋ฅผ ๊ฒ์ํฉ๋๋ค. |
get_external_links | ๐ ๋ฒ๋ น/ํ๋ก ID๋ก ๊ตญ๊ฐ๋ฒ๋ น์ ๋ณด์ผํฐ ๊ณต์ ์น์ฌ์ดํธ URL์ ์์ฑํฉ๋๋ค. ์๋ณธ ์ถ์ฒ ํ์ธ์ด๋ ๊ณต์ ์ฉ ๋งํฌ๊ฐ ํ์ํ ๋ ์ฌ์ฉํฉ๋๋ค. |
get_article_history | ๐ ๋ฒ๋ น์ ์ฐํ ์ ๋ณด(์ ๊ฐ์ ๊ตฌ๋ถ, ์ํ์ผ, ๊ฐ์ ์ด์ ๋ฑ)๋ฅผ ์กฐํํฉ๋๋ค. "๊ณ ๋ฑ๊ต์ก๋ฒ ์ธ์ ๊ฐ์ ๋์ด?"๋ผ๊ณ ๋ฌผ์ผ๋ฉด ์ฌ์ฉํฉ๋๋ค. |
compare_old_new | ๐ ์ ๊ตฌ์กฐ๋ฌธ๋๋น. ๋ฒ๋ น ๊ฐ์ ์ ํ๋ฅผ ๋น๊ตํ์ฌ ์ด๋ค ์กฐ๋ฌธ์ด ์ด๋ป๊ฒ ๋ฐ๋์๋์ง ๋ณด์ฌ์ค๋๋ค. |
๐ง AI ์ต์ ํ ํ๋กฌํํธ (System Prompt)
AI(Claude ๋ฑ)๊ฐ ์ด ๋๊ตฌ๋ฅผ ๋ ๋๋ํ๊ฒ ์ฌ์ฉํ๋๋ก ํ๋ ค๋ฉด, ์๋ ๋ด์ฉ์ **์์คํ ํ๋กฌํํธ(System Prompt)**๋ Custom Instructions์ ์ถ๊ฐํด ์ฃผ์ธ์.
## Role: Korean Law Expert (๋ํ๋ฏผ๊ตญ ๋ฒ๋ฅ ์ ๋ฌธ๊ฐ)
You are an expert legal assistant with access to the 'Korean Law MCP' tools.
Always answer in Korean unless requested otherwise.
## Guidelines for Tool Usage:
1. **Always Search First**: When asked a legal question, use 'search_korean_law' first.
- If the user specifies an article (e.g., "๋ฏผ๋ฒ ์ 103์กฐ"), search exactly for that.
- If the query is broad (e.g., "ํ๊ตํญ๋ ฅ"), search for keywords.
2. **ID-based Retrieval**:
- The search result often provides Typed IDs (e.g., 'statute:12345').
- To read the full content, MUST use 'read_legal_resource' with this ID.
3. **Complex Analysis (Deep Search)**:
- If the user asks for a comprehensive review of a specific provision (including its enforcement decrees/rules and references), USE 'explore_legal_chain'.
- Example: "Analyze Article 20 of Higher Education Act strictly." -> 'explore_legal_chain("Higher Education Act Article 20")'
4. **Formatting**:
- Present legal texts clearly with blockquotes or code blocks if necessary.
- Always cite the source (Law Name, Article Number).
๐ฉโ๐ป ๊ฐ๋ฐ์ ๋ฐ ๊ณ ๊ธ ์ฌ์ฉ์์ฉ (Advanced)
์์ค ์ฝ๋๋ฅผ ์ง์ ์์ ํ๊ฑฐ๋, PyPI์์ ์ง์ ์ค์นํ์ฌ ์ฌ์ฉํ๊ณ ์ถ์ ๊ฒฝ์ฐ์ ์๋ด์ ๋๋ค.
1. PyPI ์ค์น (pip)
uv ์์ด ์ผ๋ฐ Python ํ๊ฒฝ์์ ์ค์นํ๋ ค๋ฉด:
pip install korean-law-mcp
์ค์น ํ์๋ claude_desktop_config.json์์ command๋ฅผ "python", "-m", "korean_law_mcp" ๋ฑ์ผ๋ก ์ค์ ํ์ฌ ์ฐ๊ฒฐํฉ๋๋ค.
2. ๋ก์ปฌ ๊ฐ๋ฐ ๋ฐ ๋๋ฒ๊น
์ด ๋ ํฌ์งํ ๋ฆฌ๋ฅผ ํด๋ก ํ์ฌ ๊ฐ๋ฐํ๋ ๊ฒฝ์ฐ:
# ์์กด์ฑ ์ค์น
uv sync
# ๋๋ฒ๊น
(MCP Inspector ์ฌ์ฉ)
npx @modelcontextprotocol/inspector uv run korean-law-mcp
์ฐธ๊ณ : ์ด ํ๋ก๊ทธ๋จ์ ๋จ๋ ์คํ ์ ์๋ฌด๋ฐ ๋ฐ์์ด ์๋ ๊ฒ์ด ์ ์์ ๋๋ค. (MCP ํ๋กํ ์ฝ ํต์ ๋๊ธฐ ์ค) ๋ฐ๋์ MCP Inspector๋ Claude Desktop์ ํตํด ์คํํ์ธ์.
๋ฌธ์ ๋ฐ ๊ธฐ์ฌ: ๋ฒ๊ทธ ์ ๋ณด๋ ๊ธฐ๋ฅ ์ ์์ GitHub Issues์ ๋จ๊ฒจ์ฃผ์ธ์.
