🇰🇷 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

🔧 확장 방법 (고급)

• 실제 eum.go.kr 검색 API 연동 → search_land_use.ts의 TODO 주석 참고
• vworld.kr 또는 data.go.kr OpenAPI 키 추가 → .env에 등록
• Puppeteer로 더 정교한 스크래핑 추가 가능

📜 라이선스 & 기여

MIT License
이 프로젝트는 세계 최고의 MCP 설계자가 korean-law-mcp 아키텍처를 완벽 재현하여 제작했습니다.

토지·부동산·도시계획 관련 AI 에이전트를 만들고 싶다면 이 MCP를 강력 추천합니다!

---

문의 / 기여 환영
이슈나 PR 언제든지 보내주세요. 대한민국 토지 정보의 민주화에 함께합시다! 🏗️🇰🇷 #� �k�o�r�e�a�n�-�l�a�n�d�-�m�c�p� � �