Korean Public Data README

"서울 내일 날씨 어때?"
"강남구 2026년 2월 아파트 실거래가 알려줘"
"지금 미세먼지 어때?"
"최근 기준금리 추이 알려줘"
"사업자번호 1234567890 조회해줘"

┌─────────────────┐     MCP Protocol     ┌──────────────────────┐
│  AI 에이전트     │ ◄──────────────────► │  Korean Public Data  │
│  (Claude, etc)  │                      │  MCP Server          │
└─────────────────┘                      └──────┬───────────────┘
                                                │
                              ┌─────────────────┼─────────────────┐
                              │                 │                 │
                        ┌─────▼─────┐    ┌──────▼──────┐   ┌─────▼─────┐
                        │ 공공데이터 │    │  에어코리아  │   │ 한국은행  │
                        │  포털 API  │    │     API     │   │ ECOS API │
                        │ (4개 API) │    │             │   │          │
                        └───────────┘    └─────────────┘   └──────────┘

                        날씨 · 부동산      대기질 실시간      경제통계
                        사업자 조회                          금리 · 환율

# 설치
git clone https://github.com/SongT-50/korean-public-data-mcp.git
cd korean-public-data-mcp
pip install -r requirements.txt

# API 키 설정
cp .env.example .env
# .env 파일에 API 키 입력 (아래 "API 키 발급" 참고)

# Claude Code에 등록
claude mcp add korean-public-data -- python server.py

{
  "mcpServers": {
    "korean-public-data": {
      "command": "python",
      "args": ["/path/to/korean-public-data-mcp/server.py"],
      "env": {
        "DATA_GO_KR_API_KEY": "your_key",
        "ECOS_API_KEY": "your_ecos_key"
      }
    }
  }
}

# Claude Code
claude mcp add korean-public-data --transport streamable-http https://korean-public-data-mcp.onrender.com/mcp

// Claude Desktop
{
  "mcpServers": {
    "korean-public-data": {
      "transport": "streamable-http",
      "url": "https://korean-public-data-mcp.onrender.com/mcp"
    }
  }
}

"서울 내일 날씨 어때?"
"제주 72시간 예보 알려줘"
"부산 오늘 비 와?"

"강남구 2026년 2월 아파트 실거래가"
"송파구 최근 거래 보여줘"
"분당 아파트 가격 어때?"

"지금 서울 미세먼지 어때?"
"강남 초미세먼지 확인해줘"
"제주 대기질 좋아?"

"최근 기준금리 추이"
"올해 코스피 흐름 보여줘"
"원달러 환율 변화"

"사업자번호 1234567890 유효한지 확인해줘"
"이 사업자 폐업했는지 알려줘"

korean-public-data-mcp/
├── server.py          # MCP 서버 (6개 도구)
├── requirements.txt   # Python 의존성
├── mcpize.yaml        # MCPize 배포 설정
├── .env.example       # API 키 템플릿
├── Dockerfile         # 컨테이너 배포
└── README.md          # 이 문서