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 分