{"_id":"@2seo/k-law","name":"@2seo/k-law","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@2seo/k-law","version":"1.0.0","description":"Korean Law MCP Server - Search and retrieve Korean laws, precedents, and regulations (한국 법률 MCP 서버)","main":"dist/index.js","types":"dist/index.d.ts","bin":{"k-law":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"ts-node src/index.ts","prepublishOnly":"npm run build"},"keywords":["law","korea","korean","legal","mcp","model-context-protocol","llm","법률","한국법","법령","판례","국가법령정보센터","law.go.kr"],"author":{"name":"2seo","email":"iyu974895@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/2seo/k-law.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.6.0","fast-xml-parser":"^4.3.0"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.0","ts-node":"^10.9.2"},"engines":{"node":">=18.0.0"},"_id":"@2seo/k-law@1.0.0","bugs":{"url":"https://github.com/2seo/k-law/issues"},"homepage":"https://github.com/2seo/k-law#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-Ho4hjjvEWnCyrClFZSVhBJ19PeW4EecTdllRr7pxBSoVdVEc5Km6Sy+gTAbCnoktgSngAtuyu97V8XDhUU3nLw==","shasum":"10aa2262b5a21c526ef226f4c902791e84d796a2","tarball":"https://registry.npmjs.org/@2seo/k-law/-/k-law-1.0.0.tgz","fileCount":9,"unpackedSize":37247,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD4J4VpmbSSf9mVlrhM5hogElpU5BD314dQsmlLx+FxDQIgDLl+mO2v276AM69JqI+HGASVpKu/07T3bzQLC8YJhgE="}]},"_npmUser":{"name":"2seo","email":"iyu974895@gmail.com"},"directories":{},"maintainers":[{"name":"2seo","email":"iyu974895@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/k-law_1.0.0_1765203482800_0.9957489396864068"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-08T14:18:02.726Z","1.0.0":"2025-12-08T14:18:02.936Z","modified":"2025-12-08T14:18:03.230Z"},"maintainers":[{"name":"2seo","email":"iyu974895@gmail.com"}],"description":"Korean Law MCP Server - Search and retrieve Korean laws, precedents, and regulations (한국 법률 MCP 서버)","homepage":"https://github.com/2seo/k-law#readme","keywords":["law","korea","korean","legal","mcp","model-context-protocol","llm","법률","한국법","법령","판례","국가법령정보센터","law.go.kr"],"repository":{"type":"git","url":"git+https://github.com/2seo/k-law.git"},"author":{"name":"2seo","email":"iyu974895@gmail.com"},"bugs":{"url":"https://github.com/2seo/k-law/issues"},"license":"MIT","readme":"# ⚖️ k-law\n\n**Korean Law MCP Server** - Search and retrieve Korean laws, precedents, and regulations.\n\n한국 법률, 판례, 행정규칙을 검색하고 조회하는 MCP(Model Context Protocol) 서버입니다.\n\n## 🎯 Features\n\n- **통합 검색** (`search_total`): 지능형 법령검색 API를 활용한 법령/판례/행정규칙 통합 검색\n- **본문 조회** (`get_law_content`): 특정 법령의 전문 또는 특정 조문 조회\n\n## 📦 Installation\n\n```bash\nnpm install k-law\n```\n\n## 🔧 MCP Configuration\n\n### Claude Desktop\n\n`claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"k_law\": {\n      \"command\": \"npx\",\n      \"args\": [\"k-law\"]\n    }\n  }\n}\n```\n\n### Cursor\n\n`.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"k_law\": {\n      \"command\": \"npx\",\n      \"args\": [\"k-law\"]\n    }\n  }\n}\n```\n\n## 🛠️ Tools\n\n### 1. `search_total` (통합 검색)\n\n지능형 법령검색 API를 사용하여 한국의 법률, 판례, 행정규칙 등을 키워드로 검색합니다.\n\n**Parameters:**\n| 파라미터 | 타입 | 필수 | 설명 |\n|---------|------|------|------|\n| `query` | string | ✅ | 검색 키워드 |\n| `target` | string | - | 검색 대상: `law`(법령), `prec`(판례), `ordin`(조례/규칙), `admrul`(행정규칙), `all`(전체). 기본값: `law` |\n| `page` | number | - | 페이지 번호 (기본값: 1) |\n| `display` | number | - | 한 페이지당 결과 수 (기본값: 20, 최대: 100) |\n\n**Example:**\n```\n\"근로기준법\" 검색해줘\n→ search_total(query=\"근로기준법\", target=\"law\")\n\n\"부당해고\" 판례 검색\n→ search_total(query=\"부당해고\", target=\"prec\")\n```\n\n### 2. `get_law_content` (본문 조회)\n\n법령 ID(MST)를 사용하여 특정 법률의 전문을 조회합니다.\n\n**Parameters:**\n| 파라미터 | 타입 | 필수 | 설명 |\n|---------|------|------|------|\n| `lawId` | string | ✅ | 법령 ID (MST 번호). `search_total` 결과에서 얻을 수 있습니다 |\n| `articleNo` | string | - | 특정 조문 번호 (선택). 예: `\"23\"` → 제23조만 조회 |\n\n**Example:**\n```\n근로기준법 제23조 조회\n→ get_law_content(lawId=\"123456\", articleNo=\"23\")\n\n근로기준법 전문 조회\n→ get_law_content(lawId=\"123456\")\n```\n\n## 📋 Use Cases\n\n### 1. 법령 검색 및 조문 확인\n```\nUser: 근로기준법에서 해고 관련 조항 찾아줘\n\nAI: \n1. search_total(query=\"근로기준법\") → 법령 ID 획득\n2. get_law_content(lawId=\"...\", articleNo=\"23\") → 제23조(해고의 제한) 조회\n```\n\n### 2. 판례 검색\n```\nUser: 부당해고 관련 대법원 판례 검색해줘\n\nAI:\nsearch_total(query=\"부당해고\", target=\"prec\") → 관련 판례 목록 반환\n```\n\n### 3. AI 법률 문서 검증\n```\nUser: 이 계약서의 법적 근거가 맞는지 확인해줘\n\nAI:\n1. 계약서에서 인용된 법령 파악\n2. search_total로 해당 법령 검색\n3. get_law_content로 실제 조문 확인\n4. 인용된 내용과 실제 조문 비교\n```\n\n## 🔗 Data Source\n\n이 서버는 **국가법령정보센터 (law.go.kr)** OpenAPI를 사용합니다.\n\n- [법령정보 오픈 API](https://open.law.go.kr/)\n\n## 📄 License\n\nMIT\n\n## 👨‍💻 Author\n\n2seo <iyu974895@gmail.com>\n\n---\n\n> 📢 **Note**: 실제 서비스 사용 시에는 국가법령정보센터에서 OpenAPI 인증키를 발급받아 사용하세요.\n\n","readmeFilename":"README.md","_rev":"1-c23dde7e671d26d18b027431d2a81d1f"}