Korean Public Data

io.github.SongT-50由 GitHub 帳號 SongT-50 發布v1.0.0更新於 Nov 1, 2026

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

已驗證Streamable HTTP可網頁執行位置與生活金融資料與分析

概覽

AI 產生的概覽

讓助理查詢韓國公共資料：天氣、公寓實際成交價、空氣品質、經濟統計與營業登記狀態。

可以做什麼
  • 批次查詢營業登記狀態，一次最多 100 個號碼
  • 依地區與月份取得公寓實際成交紀錄
  • 查詢主要城市未來最長 72 小時的短期天氣預報
  • 取得主要地區的即時空氣品質數值與等級
  • 讀取韓國銀行經濟時間序列，如利率、物價、GDP、進出口與匯率
  • 列出支援的城市、地區與指標清單
適用情境
適合用自然語言詢問韓國天氣、公寓房價、空氣品質、總體指標，或某營業登記號碼是否仍有效，而不必逐一造訪政府網站。
執行需求
遠端方式：使用已部署的 streamable HTTP 端點，無需安裝或金鑰。本機方式：Python 3.10+ 與專案相依套件，並在環境變數中設定 data.go.kr 與韓國銀行 ECOS 的 API 金鑰（DATA_GO_KR_API_KEY、ECOS_API_KEY）。金鑰免費但有每日呼叫上限。
安裝前請注意
免費託管實例閒置會休眠，首次請求可能需 30 至 60 秒。本機安裝需自備 data.go.kr 與 ECOS 金鑰，金鑰會傳送給對應的公共 API。送出的營業登記號碼會傳送至國稅廳 API。所有工具皆為唯讀查詢。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Korean Public Data，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.SongT-50%2Fkorean-public-data-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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 코딩으로 실제 제품을 만드는 기록

來源：README.md，提交 7edd8de

工具

6

check_business_registration

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

輸入參數business_numbers必填

get_real_estate_trades

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

輸入參數district必填year_month必填

get_weather_forecast

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

輸入參數city必填hours_ahead

get_air_quality

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

輸入參數location必填

get_economic_stats

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

輸入參數periodindicator必填

list_supported_options

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

無需輸入參數。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分