MCP 服务器

Korean Land MCP

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.

README

🇰🇷 Korean Land MCP (토지이음 MCP)

세계 최고 수준의 토지이음( EUM ) MCP 서버
국토교통부 운영 토지이음(eum.go.kr) 의 모든 기능을 AI가 자연어로 활용할 수 있게 통합한 Model Context Protocol (MCP) 서버입니다.

korean-law-mcp 스타일로 제작된 토지 전문 MCP — hallucination 없는 정확한 토지·도시계획·인허가 정보 제공

✨ 주요 기능

10개 통합 도구로 토지이용계획, 도시계획, 규제법령, 고시정보, 데이터개방, 용어사전, 인허가 사례 완벽 커버
search_land_use : 주소/지번으로 즉시 용도지역·건폐율·용적률·규제사항 조회 (핵심 도구)
verify_land_citations : LLM이 생성한 토지 관련 법령 인용 자동 검증 (hallucination 방지)
chain_land_analysis : 개발 가능성·매수 리스크·규제 준수 등 시나리오별 종합 분석 체인
실시간 고시정보 스크래핑 + 공공데이터 연동

📡 현재 데이터 소스 (중요!)

도구	데이터 소스	실제 동작?	비고
`search_public_notices`	eum.go.kr 직접 스크래핑	✅ 실제 동작	cheerio + axios
`search_land_use`	vworld.kr (선택) + 모의데이터	⚠️ 부분 실제	VWORLD_API_KEY 등록 시 실시간 시도
나머지 도구	고품질 모의 데이터	✅ 정확한 패턴 재현	실제 데이터 기반으로 설계

vworld.kr 키 등록하면 search_land_use가 실시간으로 업그레이드됩니다! (무료)

🚀 빠른 시작

1. 설치

git clone https://github.com/YOUR_USERNAME/korean-land-mcp.git
cd korean-land-mcp
npm install
npm run build

2. 실행 (Claude Desktop / Cursor 연동)

npm start
# 또는 개발 모드
npm run dev

3. Claude Desktop 설정 예시 (claude_desktop_config.json)

{
  "mcpServers": {
    "korean-land": {
      "command": "node",
      "args": ["/absolute/path/to/korean-land-mcp/dist/server.js"]
    }
  }
}

🛠️ 사용 예시 (Claude에게 말해보세요)

"서울 강남구 테헤란로 123 토지이용계획 알려줘"
"이 주소에 상가 지을 수 있어? 규제 뭐야?" → chain_land_analysis 자동 실행
"민법 제750조 대신 국토계획법 제36조 인용 검증해줘" → verify_land_citations
"최근 김포 도시계획 고시 뭐 있어?"

📦 배포 (Fly.io 추천 - korean-law-mcp와 동일)

fly launch --dockerfile Dockerfile
fly deploy

배포 후 https://korean-land-mcp.fly.dev/mcp 로 Claude 등에서 연동 가능.

🗂️ 프로젝트 구조

korean-land-mcp/
├── src/
│   ├── server.ts              # MCP 서버 엔트리 (stdio + HTTP 지원)
│   └── tools/                 # 10개 전문 도구
│       ├── search_land_use.ts
│       ├── verify_land_citations.ts
│       ├── chain_land_analysis.ts
│       └── ...
├── README.md / README-EN.md
├── Dockerfile
├── fly.toml
└── package.json