Korea MCP Suite

한국 공공 데이터를 Claude, Cursor, Windsurf 등 MCP 호환 AI에 연결하는 MCP 서버입니다.

제공 도구 (10개)

| 분류 | 도구 | 설명 | |------|------|------| | 날씨 | get_current_weather | 현재 날씨 요약 (기온, 하늘, 강수, 습도, 풍속) | | 날씨 | get_weather_forecast | 최대 72시간 단기 예보 (기상청) | | 교통 | get_subway_arrival | 서울 지하철 실시간 도착 정보 | | 교통 | search_subway_station | 역명 키워드 검색 | | 교통 | get_bus_arrival | 서울 버스 정류소 실시간 도착 정보 | | 부동산 | get_apartment_trade | 아파트 매매 실거래가 (국토교통부) | | 부동산 | get_apartment_rent | 아파트 전월세 실거래 정보 | | 주소 | search_address | 도로명주소 검색 (행정안전부) | | 주소 | get_address_coordinates | 주소 → 위경도 좌표 변환 | | 주소 | get_zip_code | 주소 → 우편번호 조회 |

설치

git clone https://github.com/your-id/korea-mcp-suite
cd korea-mcp-suite

# 환경변수 설정
cp .env.example .env
# .env 파일에 API 키 입력

# 의존성 설치
uv sync

API 키 발급

| API | 발급처 | 무료 여부 | |-----|--------|---------| | 기상청 단기예보 | data.go.kr | 무료 | | 서울 열린데이터 | data.seoul.go.kr | 무료 | | 공공데이터포털 | data.go.kr | 무료 | | 도로명주소 | juso.go.kr | 무료 |

Claude Desktop 연결

~/.claude/claude_desktop_config.json 에 추가:

{
  "mcpServers": {
    "korea-mcp-suite": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/yongrean/Downloads/korea-mcp-suite",
        "run",
        "korea-mcp"
      ]
    }
  }
}

Claude Code 연결

claude mcp add korea-mcp-suite \
  uv --directory /Users/yongrean/Downloads/korea-mcp-suite run korea-mcp

사용 예시

"서울 날씨 알려줘"
"강남역 지하철 몇 분 후에 와?"
"강남구 아파트 이번달 실거래가 보여줘"
"판교역로 235 우편번호 알려줘"

프로젝트 구조

src/korea_mcp/
├── server.py           # MCP 서버 진입점
├── tools/
│   ├── weather.py      # 기상청 단기예보
│   ├── transit.py      # 서울 지하철/버스
│   ├── realestate.py   # 부동산 실거래가
│   └── address.py      # 도로명주소
└── utils/
    └── http.py         # 공통 HTTP 클라이언트

로드맵

[ ] 네이버 검색/지도 API (naver-mcp)
[ ] 카카오 통합 API (kakao-unified-mcp)
[ ] 주식/환율/암호화폐 금융 데이터
[ ] 의약품 정보 (식약처)

라이선스

MIT

MCP Servers