[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_121":122},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97},"apiUrl","https://odel.app/api","creator","songt-50","moduleId","korean-public-data-mcp","@songt-50/korean-public-data-mcp","displayName","Korean Public Data","tagline","Korean government open data - weather, population, law search via data.go.kr","iconKey","https://avatars.githubusercontent.com/u/174168364?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://korean-public-data-mcp.onrender.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363369000,"updatedAt",1788776660000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.SongT-50%2Fkorean-public-data-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1773014381000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/SongT-50/korean-public-data-mcp","githubRepoFullName","SongT-50/korean-public-data-mcp","releaseId","ext-songt-50-korean-public-data-mcp","version","1.0.0","descriptionMarkdown","

\n $\"Korean$ \n

\n\n

\n 한국 공공데이터 5개를 AI에게 연결합니다
\n 날씨 · 부동산 실거래가 · 대기질 · 경제통계 · 사업자조회\n

\n\n

\n $\"MIT$ \n $\"MCP$ \n $\"Python\"$ \n $\"Claude\"$ \n $\"Claude$ \n $\"Data.go.kr\"$ \n $\"Free\"$ \n
\n $\"Deploy$ \n

\n\n---\n\n## 뭘 할 수 있나요?\n\nAI에게 한국 공공데이터를 물어보세요. 자연어로 질문하면 실시간 데이터를 가져옵니다.\n\n```\n\"서울 내일 날씨 어때?\"\n\"강남구 2026년 2월 아파트 실거래가 알려줘\"\n\"지금 미세먼지 어때?\"\n\"최근 기준금리 추이 알려줘\"\n\"사업자번호 1234567890 조회해줘\"\n```\n\n## 제공 도구 (6개)\n\n| 도구 | 설명 | 데이터 출처 |\n|------|------|-------------|\n| `check_business_registration` | 사업자등록번호 상태 조회 (최대 100건 일괄) | 국세청 |\n| `get_real_estate_trades` | 아파트 실거래가 조회 (서울 25구 + 주요 도시) | 국토교통부 |\n| `get_weather_forecast` | 단기 날씨 예보 (25개 도시, 72시간) | 기상청 |\n| `get_air_quality` | 실시간 대기질 (PM10, PM2.5, 오존 등) | 에어코리아 |\n| `get_economic_stats` | 경제통계 (금리, 물가, 환율, 코스피 등 8종) | 한국은행 ECOS |\n| `list_supported_options` | 지원 지역/도시/지표 목록 확인 | — |\n\n## 아키텍처\n\n```\n┌─────────────────┐ MCP Protocol ┌──────────────────────┐\n│ AI 에이전트 │ ◄──────────────────► │ Korean Public Data │\n│ (Claude, etc) │ │ MCP Server │\n└─────────────────┘ └──────┬───────────────┘\n │\n ┌─────────────────┼─────────────────┐\n │ │ │\n ┌─────▼─────┐ ┌──────▼──────┐ ┌─────▼─────┐\n │ 공공데이터 │ │ 에어코리아 │ │ 한국은행 │\n │ 포털 API │ │ API │ │ ECOS API │\n │ (4개 API) │ │ │ │ │\n └───────────┘ └─────────────┘ └──────────┘\n\n 날씨 · 부동산 대기질 실시간 경제통계\n 사업자 조회 금리 · 환율\n```\n\n## 빠른 시작\n\n### 1. Claude Code (권장)\n\n```bash\n# 설치\ngit clone https://github.com/SongT-50/korean-public-data-mcp.git\ncd korean-public-data-mcp\npip install -r requirements.txt\n\n# API 키 설정\ncp .env.example .env\n# .env 파일에 API 키 입력 (아래 \"API 키 발급\" 참고)\n\n# Claude Code에 등록\nclaude mcp add korean-public-data -- python server.py\n```\n\n### 2. Claude Desktop\n\n`~/.claude/settings.json`에 추가:\n\n```json\n{\n \"mcpServers\": {\n \"korean-public-data\": {\n \"command\": \"python\",\n \"args\": [\"/path/to/korean-public-data-mcp/server.py\"],\n \"env\": {\n \"DATA_GO_KR_API_KEY\": \"your_key\",\n \"ECOS_API_KEY\": \"your_ecos_key\"\n }\n }\n }\n}\n```\n\n### 3. 원격 접속 (설치 없이)\n\nRender에 배포된 서버를 바로 사용할 수 있습니다.\n\n```bash\n# Claude Code\nclaude mcp add korean-public-data --transport streamable-http https://korean-public-data-mcp.onrender.com/mcp\n```\n\n```json\n// Claude Desktop\n{\n \"mcpServers\": {\n \"korean-public-data\": {\n \"transport\": \"streamable-http\",\n \"url\": \"https://korean-public-data-mcp.onrender.com/mcp\"\n }\n }\n}\n```\n\n> 무료 Render 인스턴스는 비활성 시 슬립됩니다. 첫 요청에 30~60초 걸릴 수 있습니다.\n> 원격 서버의 API 키는 서버에 설정되어 있습니다. 로컬 설치 시에만 본인의 키가 필요합니다.\n\n### 4. MCPize (설치 없이)\n\n[MCPize에서 바로 사용하기](https://mcpize.com/mcp/korean-public-data)\n\n## API 키 발급 (무료)\n\n| API | 발급처 | 소요 시간 |\n|-----|--------|-----------|\n| 공공데이터포털 (4개 API 공통) | [data.go.kr](https://www.data.go.kr) → 회원가입 → API 활용신청 | 즉시 승인 |\n| 한국은행 ECOS (경제통계) | [ecos.bok.or.kr/api](https://ecos.bok.or.kr/api) → API 키 발급 | 즉시 발급 |\n\n> 모든 API는 **무료**입니다. 일일 호출 제한이 있지만 개인 사용에는 충분합니다.\n\n## 지원 범위\n\n

날씨 예보 — 25개 도시

\n\n서울, 부산, 대구, 인천, 광주, 대전, 울산, 세종, 수원, 성남, 고양, 용인, 창원, 청주, 전주, 천안, 제주, 춘천, 원주, 강릉, 포항, 김해, 파주, 화성, 평택\n

\n\n

부동산 실거래가 — 서울 25구 + 주요 도시

\n\n**서울**: 강남구, 강동구, 강북구, 강서구, 관악구, 광진구, 구로구, 금천구, 노원구, 도봉구, 동대문구, 동작구, 마포구, 서대문구, 서초구, 성동구, 성북구, 송파구, 양천구, 영등포구, 용산구, 은평구, 종로구, 중구, 중랑구\n\n**경기**: 성남시분당구, 수원시영통구, 고양시일산서구, 용인시수지구, 화성시, 평택시\n\n**광역시**: 부산해운대구, 대구수성구, 인천연수구, 대전유성구\n

\n\n

대기질 — 15개 지역

\n\n서울(중구), 강남, 송파, 마포, 종로, 영등포, 부산, 대구, 인천, 광주, 대전, 울산, 수원, 성남, 제주\n

\n\n

경제통계 — 8개 지표

\n\n기준금리, 소비자물가지수, 실업률, GDP성장률, 수출액, 수입액, 원달러환율, 코스피\n

\n\n## 사용 예시\n\n### 날씨\n```\n\"서울 내일 날씨 어때?\"\n\"제주 72시간 예보 알려줘\"\n\"부산 오늘 비 와?\"\n```\n\n### 부동산\n```\n\"강남구 2026년 2월 아파트 실거래가\"\n\"송파구 최근 거래 보여줘\"\n\"분당 아파트 가격 어때?\"\n```\n\n### 대기질\n```\n\"지금 서울 미세먼지 어때?\"\n\"강남 초미세먼지 확인해줘\"\n\"제주 대기질 좋아?\"\n```\n\n### 경제\n```\n\"최근 기준금리 추이\"\n\"올해 코스피 흐름 보여줘\"\n\"원달러 환율 변화\"\n```\n\n### 사업자 조회\n```\n\"사업자번호 1234567890 유효한지 확인해줘\"\n\"이 사업자 폐업했는지 알려줘\"\n```\n\n## 기술 스택\n\n| 항목 | 기술 |\n|------|------|\n| 언어 | Python 3.10+ |\n| MCP SDK | `mcp[cli]` (FastMCP) |\n| HTTP | `httpx` (async) |\n| XML 파싱 | `xmltodict` |\n| 전송 | stdio / SSE / Streamable HTTP |\n| 배포 | 로컬 / MCPize |\n\n## 프로젝트 구조\n\n```\nkorean-public-data-mcp/\n├── server.py # MCP 서버 (6개 도구)\n├── requirements.txt # Python 의존성\n├── mcpize.yaml # MCPize 배포 설정\n├── .env.example # API 키 템플릿\n├── Dockerfile # 컨테이너 배포\n└── README.md # 이 문서\n```\n\n## 라이선스\n\nMIT License — 자유롭게 사용, 수정, 배포할 수 있습니다.\n\n## 만든 사람\n\n**삽질코딩** — AI 코딩으로 실제 제품을 만드는 기록\n\n- YouTube: [삽질코딩](https://www.youtube.com/channel/UCSHxaZHNDOrp0h0Ux8_6CVQ)\n- GitHub: [SongT-50](https://github.com/SongT-50)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_108":109,"_110":111,"_112":113,"_114":115,"_116":-5,"_117":118},"requiredSecrets",[],"tags",[100,101,102,103,104,105,106,107],"assets",[],"stats",{"_98":85,"_99":85},"ratingAvg","reviewCount","ai","air-quality","claude","economics","korea","public-data","real-estate","weather","topics",[100,101,102,103,104,119,120,105,106,107],"license","MIT","language","Python","registryName","io.github.SongT-50/korean-public-data-mcp","homepage","packages",[],"mcp","mcp-server","ENV",{"_123":124,"_125":126,"_127":128},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]