Korean Public Data

io.github.SongT-50Published by GitHub account SongT-50v1.0.0Updated Nov 1, 2026

Korean government open data - weather, population, law search via data.go.kr

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceData & Analytics

Overview

AI-generated overview

Connects an assistant to South Korean public data: weather, apartment real-estate trades, air quality, economic statistics and business registration status.

What you can do
  • Look up business registration status for up to 100 numbers at once
  • Retrieve apartment real-estate transaction records by district and month
  • Get short-term weather forecasts for major cities, up to 72 hours ahead
  • Check real-time air quality readings and grades for major regions
  • Pull Bank of Korea economic time series such as rates, CPI, GDP, trade and exchange rate
  • List the supported cities, districts and indicators
When to use it
Useful when you want to ask questions in natural language about Korean weather, apartment prices, air pollution, macro indicators or whether a business number is still active, without visiting each government portal.
Requirements
Remote option: the hosted streamable HTTP endpoint, no install or key needed. Local option: Python 3.10+ with the project's dependencies, plus a data.go.kr API key and a Bank of Korea ECOS API key set in the environment (DATA_GO_KR_API_KEY, ECOS_API_KEY). Free API keys with daily call limits.
Before you install
The hosted free instance sleeps when idle, so the first request can take 30-60 seconds. Local installs require your own data.go.kr and ECOS API keys, which are sent to those public APIs. Business registration numbers you submit are sent to the National Tax Service API. All tools are read-only lookups.

Installation

In SourceWeft

  1. Open Korean Public Data in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.SongT-50%2Fkorean-public-data-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "korean-public-data": {
      "type": "http",
      "url": "https://korean-public-data-mcp.onrender.com/mcp"
    }
  }
}

README

[Korean Public Data MCP]

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

[MIT License] [MCP Protocol] [Python] [Claude] [Claude Code] [Data.go.kr] [Free]
[Deploy to Render]

뭘 할 수 있나요?

AI에게 한국 공공데이터를 물어보세요. 자연어로 질문하면 실시간 데이터를 가져옵니다.

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

제공 도구 (6개)

도구설명데이터 출처
check_business_registration사업자등록번호 상태 조회 (최대 100건 일괄)국세청
get_real_estate_trades아파트 실거래가 조회 (서울 25구 + 주요 도시)국토교통부
get_weather_forecast단기 날씨 예보 (25개 도시, 72시간)기상청
get_air_quality실시간 대기질 (PM10, PM2.5, 오존 등)에어코리아
get_economic_stats경제통계 (금리, 물가, 환율, 코스피 등 8종)한국은행 ECOS
list_supported_options지원 지역/도시/지표 목록 확인—

아키텍처

┌─────────────────┐     MCP Protocol     ┌──────────────────────┐│  AI 에이전트     │ ◄──────────────────► │  Korean Public Data  ││  (Claude, etc)  │                      │  MCP Server          │└─────────────────┘                      └──────┬───────────────┘                                                │                              ┌─────────────────┼─────────────────┐                              │                 │                 │                        ┌─────▼─────┐    ┌──────▼──────┐   ┌─────▼─────┐                        │ 공공데이터 │    │  에어코리아  │   │ 한국은행  │                        │  포털 API  │    │     API     │   │ ECOS API │                        │ (4개 API) │    │             │   │          │                        └───────────┘    └─────────────┘   └──────────┘
                        날씨 · 부동산      대기질 실시간      경제통계                        사업자 조회                          금리 · 환율

빠른 시작

1. Claude Code (권장)

bash
# 설치git clone https://github.com/SongT-50/korean-public-data-mcp.gitcd korean-public-data-mcppip install -r requirements.txt
# API 키 설정cp .env.example .env# .env 파일에 API 키 입력 (아래 "API 키 발급" 참고)
# Claude Code에 등록claude mcp add korean-public-data -- python server.py

2. Claude Desktop

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

json
{  "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"      }    }  }}

3. 원격 접속 (설치 없이)

Render에 배포된 서버를 바로 사용할 수 있습니다.

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

무료 Render 인스턴스는 비활성 시 슬립됩니다. 첫 요청에 30~60초 걸릴 수 있습니다. 원격 서버의 API 키는 서버에 설정되어 있습니다. 로컬 설치 시에만 본인의 키가 필요합니다.

4. MCPize (설치 없이)

MCPize에서 바로 사용하기

API 키 발급 (무료)

API발급처소요 시간
공공데이터포털 (4개 API 공통)data.go.kr → 회원가입 → API 활용신청즉시 승인
한국은행 ECOS (경제통계)ecos.bok.or.kr/api → API 키 발급즉시 발급

모든 API는 무료입니다. 일일 호출 제한이 있지만 개인 사용에는 충분합니다.

지원 범위

날씨 예보 — 25개 도시

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

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

서울: 강남구, 강동구, 강북구, 강서구, 관악구, 광진구, 구로구, 금천구, 노원구, 도봉구, 동대문구, 동작구, 마포구, 서대문구, 서초구, 성동구, 성북구, 송파구, 양천구, 영등포구, 용산구, 은평구, 종로구, 중구, 중랑구

경기: 성남시분당구, 수원시영통구, 고양시일산서구, 용인시수지구, 화성시, 평택시

광역시: 부산해운대구, 대구수성구, 인천연수구, 대전유성구

대기질 — 15개 지역

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

경제통계 — 8개 지표

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

사용 예시

날씨

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

부동산

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

대기질

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

경제

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

사업자 조회

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

기술 스택

항목기술
언어Python 3.10+
MCP SDKmcp[cli] (FastMCP)
HTTPhttpx (async)
XML 파싱xmltodict
전송stdio / SSE / Streamable HTTP
배포로컬 / MCPize

프로젝트 구조

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

라이선스

MIT License — 자유롭게 사용, 수정, 배포할 수 있습니다.

만든 사람

삽질코딩 — AI 코딩으로 실제 제품을 만드는 기록

Source: README.md at commit 7edd8de

Tools

6

check_business_registration

사업자등록번호로 사업 상태를 조회합니다. Args: business_numbers: 사업자등록번호 리스트 (예: ["1234567890", "0987654321"]). 하이픈 없이 10자리 숫자. 최대 100개. Returns: 각 사업자의 등록 상태 (계속사업자, 휴업자, 폐업자 등)

Parametersbusiness_numbersrequired

get_real_estate_trades

아파트 실거래가를 조회합니다. Args: district: 지역구 이름 (예: "강남구", "서초구", "성남시분당구"). 서울 25개구 + 주요 경기/광역시 지원. year_month: 조회할 연월 (예: "202602"). YYYYMM 형식. Returns: 해당 지역/기간의 아파트 실거래 내역 (단지명, 면적, 가격, 층, 거래일)

Parametersdistrictrequiredyear_monthrequired

get_weather_forecast

도시별 단기 날씨 예보를 조회합니다. Args: city: 도시 이름 (예: "서울", "부산", "제주", "수원"). 25개 주요 도시 지원. hours_ahead: 앞으로 몇 시간 예보를 볼지 (기본 24시간, 최대 72시간) Returns: 시간대별 기온, 강수확률, 하늘상태 등 날씨 정보

Parameterscityrequiredhours_ahead

get_air_quality

실시간 대기질(미세먼지, 초미세먼지, 오존 등)을 조회합니다. Args: location: 지역명 (예: "서울", "강남", "부산", "제주"). 15개 주요 지역 지원. Returns: PM10, PM2.5, 오존, 이산화질소, 일산화탄소, 아황산가스 수치와 등급

Parameterslocationrequired

get_economic_stats

한국은행 경제통계를 조회합니다. Args: indicator: 경제지표명. 지원 항목: 기준금리, 소비자물가지수, 실업률, GDP성장률, 수출액, 수입액, 원달러환율, 코스피 period: 조회기간. "latest"(최근 12개월), "2025"(특정연도), "202501-202602"(기간지정) Returns: 해당 경제지표의 시계열 데이터

Parametersperiodindicatorrequired

list_supported_options

이 MCP 서버에서 지원하는 도시, 지역, 경제지표 목록을 확인합니다. Returns: 각 도구별 지원 옵션 목록

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts