loading…
Spring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
автор: Community
0.00
Search for a command to run...
loading…
Provides AI access to Korea's land use planning, urban regulations, and permit information through natural language queries. It integrates tools for land analys
Provides AI access to Korea's land use planning, urban regulations, and permit information through natural language queries. It integrates tools for land analysis, regulation verification, and public notice scraping to prevent hallucinations in property-related AI applications.
V-World API 기반 토지·도시계획 공간정보 MCP 서버 국토교통부 V-World Open API를 백엔드로 사용해, 토지이음(eum.go.kr)에서 사람이 수동으로 확인하던 용도지역·용도지구·용도구역·지구단위계획·도시계획시설·다른 법령 지정사항을 AI가 자연어로 조회할 수 있게 만든 Model Context Protocol 서버입니다.
korean-law-mcp (법령 텍스트) 와 짝이 되는 공간 레이어 MCP. 두 MCP를 함께 쓰면 "이 필지가 어디에 속하는가 → 해당 법령·조례가 무엇을 허용/제한하는가" 까지 자연어 한 줄로 연결됩니다.
layer_errors에 그대로 노출. 절대 가짜 데이터로 채우지 않음.priority_delegation_hint 로 "국토계획법 시행령 별표 대신 어느 법령을 먼저 봐야 하는가"를 알려줌.| 도구 | 설명 |
|---|---|
resolve_parcel |
주소/지번/PNU → 표준화된 PNU·지목·공시지가·행정구역·WGS84 좌표 |
get_zoning |
용도지역 (도시/관리/농림/자연환경) + 용도지구 (8종) + 용도구역 (개발제한·도시자연공원) + 토지거래허가구역 |
get_district_plan |
지구단위계획구역 + 개발행위허가제한구역 |
get_urban_facility |
도시계획시설 9종 (도로·교통·공간·유통공급·공공문화체육·방재·보건위생·환경기초·기타). radius_m 파라미터로 "저촉" vs "접함" 구분 |
get_other_law_designations |
42개 다른 법령 지정 레이어 (농지·산림·산업단지·수질환경·축산·문화재·자연공원·특수지구·주거정비·재해·해양·항공). 제76조⑤ 우선 위임 후보 자동 표시 |
get_land_attributes |
지목(28종) 파싱 + 개별공시지가 + 건물 정보 |
analyze_parcel |
위 6개 도구를 한 번에 병렬 호출 + korean-law-mcp 다음 단계 힌트 생성 |
discover_tools 도 포함되어 있어 도구 카탈로그를 자연어로 탐색 가능.
LT_C_UQ111/112/113/114 (도시·관리·농림·자연환경보전 전체)LT_C_UQ121~130, LT_C_UD801, LT_C_UQ162LT_C_UPISUQ161, LT_C_UPISUQ171LT_C_UPISUQ151~159LP_PA_CBND_BUBUN, LT_C_BLDGINFO, A2SM_LNDPRCPSgit clone https://github.com/UrbanWatcherKr/korean-land-mcp.git
cd korean-land-mcp
npm run setup
npm run setup 은 npm install → npm run build → 인터랙티브 configure 순으로 실행됩니다. configure 단계에서 V-World API 키·도메인을 묻고 .env 파일을 자동 생성합니다.
V-World API 키 발급: https://www.vworld.kr/dev/v4api.do (로그인 → 오픈API → 인증키 발급, 무료). 로컬 개발용이면 도메인은 localhost로 등록.
API 키를 바꾸거나 도메인을 수정하고 싶으면 언제든:
npm run configure
configure 가 끝나면 붙여넣을 JSON 블록을 터미널에 출력합니다. 또는 수동으로:
{
"mcpServers": {
"korean-land": {
"command": "node",
"args": ["/absolute/path/to/korean-land-mcp/dist/server.js"],
"env": {
"VWORLD_API_KEY": "your_real_key_here",
"VWORLD_DOMAIN": "localhost"
}
}
}
}
get_zoningget_other_law_designationsget_urban_facility({ radius_m: 50 })analyze_parcel사용자: "이 지번에 공장 지을 수 있어?"
↓
korean-land-mcp · analyze_parcel
↓ (용도지역=일반공업, 산업단지=아산포승, 우선위임=산업입지법)
korean-law-mcp · search_law("산업입지법")
↓
korean-law-mcp · get_law_text(산업입지법 제33조)
↓
결론 + 원문 근거
src/
├── server.ts # MCP stdio 엔트리, 7개 도구 등록
├── lib/
│ ├── vworld.ts # V-World HTTP 클라이언트 (5xx 재시도 1회)
│ ├── overlays.ts # 병렬 레이어 쿼리 + POINT/BOX 필터
│ ├── resolve.ts # 주소/지번/PNU 해석
│ └── jimok.ts # 지목 코드 28종 매핑
└── tools/
├── resolve_parcel.ts
├── get_zoning.ts
├── get_district_plan.ts
├── get_urban_facility.ts
├── get_other_law_designations.ts
├── get_land_attributes.ts
└── analyze_parcel.ts
유닛 테스트 (순수 함수, API 키 불필요):
npm test
Live smoke test (실제 V-World 호출, VWORLD_API_KEY 필요):
# 단일 지번 디버그
npx tsx tests/live/smoke-polygon.ts "서울특별시 마포구 연남동 229-1"
# 3개 픽스처 회귀 테스트 (스냅샷 비교)
npx tsx tests/live/smoke-fixtures.ts
# 스냅샷 갱신 (V-World 데이터 변경 시)
npx tsx tests/live/smoke-fixtures.ts --update
Fixtures: 도시 주거지(연남동), 농림지역+우선위임(세출리), 복합 용도지역+도시개발(갈매리).
get_urban_facility 의 radius_m 는 BOX 필터로 이 한계를 완화하지만, "저촉" vs "접함" 최종 판정은 사용자 또는 담당 공무원의 폴리곤 교차 재검증이 필요.layer_errors 에 노출되며, 나머지 레이어 결과는 정상 반환된다.MIT License.
이슈·PR 환영. 새 V-World 레이어 추가 시 src/tools/*.ts 의 LAYERS 배열에 { id, label } 만 추가하면 자동으로 queryOverlays 파이프라인에 편입됩니다.
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"korean-land-mcp": {
"command": "npx",
"args": []
}
}
}