F
licenseNot graded
qualityC
maintenanceIntegrates with Claude Desktop to provide Korean financial data including stock prices, bonds, real estate transactions, and economic indicators from multiple sources.
korea-public-data-mcp
by GeeYun086
korea-public-data
대한민국 공공데이터를 Claude가 직접 조회해서 답하게 해주는 MCP 입니다.
기업 재무제표, 환율·금리 같은 경제 지표, 정부 지원사업 공고, 공공 입찰공고, 특허·학교정보·국가 R&D 과제까지 물어보면 기관 API를 실제로 호출해 받아온 값으로 답합니다. 도구 이름을 외울 필요 없이 한국어로 물어보면 됩니다.
중소기업 수출 지원사업 뭐 있어?
조달청 사전규격에 시스템 관련 뭐 올라왔어?
삼성전자 2024년 재무제표 알려줘
작년부터 지금까지 기준금리 어떻게 변했어?
이차전지 관련 국가 R&D 과제 뭐 있어?
인공지능 관련 특허 좀 찾아줘
서울 강남구에 있는 고등학교 알려줘
그 회사 국민연금 가입자수(재직자수) 추이 어때?
백엔드 개발자 채용공고 좀 찾아줘분야별 진행 현황
분야 | 상태 | 소스 |
금융 | ✅ 완료 | 4곳 |
정부사업 · 조달 | ✅ 완료 | 9곳 |
지식재산권 / 특허 | ✅ 완료 | KIPRIS Plus |
교육 | ✅ 완료 | NEIS |
학술 / 연구 | 🔶 일부 | 서울연구원(완료) · NTIS(신청자 개인 IP에서만 동작) · KCI(코드 완료, 키 발급 보류) · KISTI(승인 대기) |
인력 / 채용 | 🔶 일부 | 국민연금(완료) · 원티드(코드 완료, 키 발급 보류) · 고용24 KDT(코드 완료, 키 발급 보류) |
상태 표기: ✅ 코드 완료 + 키 발급 + 정상 호출 확인 · ⏸ 코드 완료, 키 발급 대기/보류 · ⚠️ 동작은 하지만 조건부(특정 IP·별도 신청 등) · ⛔ 제외.
금융
기관 | 제공 데이터 | 출처 |
금융감독원 OpenDART | 상장·외감법인 재무제표, 공시, 기업코드 | |
한국은행 ECOS | 기준금리, 환율, GDP, 물가 등 거시경제 통계 | |
통계청 KOSIS | 국가통계 13만종 | |
한국수출입은행 | 현재환율, 대출금리, 국제금리 |
정부사업 — 지원사업 3가지
소스 | 제공 데이터 | 출처 |
기업마당 (중소벤처기업부) | 중소기업·소상공인 지원사업 공고. 금융·기술·인력·수출·내수·창업·경영 8개 분야. 중앙부처와 지자체 공고 포함 | |
K-Startup (창업진흥원) | 창업 지원사업 공고. 예비창업자~창업 7년 이내 | |
과기정통부 사업공고 | R&D·국제협력·인프라 사업 공모 공고 |
정부사업 — 조달 6가지 (조달청 나라장터)
조달은 한 사업이 아래 6단계의 순서로 흘러갑니다.
발주계획 → 조달요청 → 사전규격 → 입찰공고 → 낙찰 → 계약
수개월 전 구매요청 2주~1달 전 지금 결과 완료단계 | 제공 데이터 | 출처 |
발주계획 | 공공기관이 미리 공개하는 발주 예정 목록. 사업명·발주기관·발주월·발주금액 | |
조달요청 | 수요기관이 조달청에 구매를 요청한 건. 요청명·수요기관·예산액 | |
사전규격 | 입찰 전 의견수렴 단계의 규격안. 사업명·수요기관·배정예산·의견마감 | |
입찰공고 | 공고명·공고기관·수요기관·배정예산·추정가격·입찰마감 | |
낙찰 | 낙찰업체·낙찰금액·낙찰률·참여업체수 | |
계약 | 계약명·수요기관·계약금액·계약방법 |
그 밖에 호출 가능한 서비스
아래는 공고가 아니라 통계·단가·코드사전 성격이라 gov_search 결과에 넣지 않았습니다.
인증키 권한은 확보되어 있고 엔드포인트도 확인되어, data_go_kr_generic_get 으로 바로 호출됩니다.
gov_list_sources 를 호출하면 주소와 오퍼레이션명이 함께 나옵니다.
서비스 | 쓰임 | 출처 |
공공조달통계정보 | 기관별·기업별·계약방법별 조달 실적 집계 | |
나라장터 가격정보현황 | 시설공통자재·시장시공 단가. 입찰 가격 산정 참고 | |
나라장터 계약과정통합공개 | 계약 체결 과정 통합 공개 | |
나라장터 사용자정보 | 등록 조달업체·수요기관 정보 | |
나라장터 업종·근거법규 | 업종 코드와 근거 법령. 입찰 참가자격 해석용 | |
나라장터쇼핑몰 품목정보 | 종합쇼핑몰 물품 카탈로그 | |
조달청 물품목록정보 | 물품 분류번호 사전 | |
조달청 물품관리정보 | 물품 내용연수 고시 | |
창업진흥원 창업공간플랫폼 | 창업 보육센터·공간 정보 | |
한국연구재단 NRIC | 연구인력 채용정보 |
지식재산권
기관 | 제공 데이터 | 출처 |
KIPRIS Plus (특허청) | 국내 특허·실용신안 서지정보. 발명명칭·초록으로 키워드 검색, 출원인·등록상태·IPC 분류 반환 |
교육
기관 | 제공 데이터 | 출처 |
NEIS (교육부) | 전국 초·중·고·특수학교 기본정보(주소·전화·홈페이지 등). 인증키 없이도 동작(5건 제한), 키가 있으면 최대 1,000건 |
학술 / 연구
기관 | 제공 데이터 | 상태 | 출처 |
서울연구원 | 연구보고서·정책리포트 등 11개 카테고리의 메타데이터(제목·날짜·저자·원문링크) | ✅ 완료 (실호출로 확인) | |
NTIS (과기정통부) | 국가 R&D 과제 키워드 검색 (과제명·연구책임자·주관기관·연구기간·연구비) | ⚠️ 신청자 개인 공인 IP에서만 동작 (실호출로 확인) — 다른 사람 PC/서버에서 호출하면 IP 미등록으로 막힌다. 회사 소속기관 정보가 이미 한 계정에 걸려 있어 동료가 재신청해도 중복으로 막힐 수 있으므로, 고정 공인 IP 서버 배포 + 기존 키의 등록 IP 갱신을 권장 | |
KCI (한국연구재단) | 국내 학술논문 제목 검색 (저자·저널명·발행연도·DOI·초록·인용횟수) | ⏸ 코드 완료, 키 발급 보류 — 신청 시 사업자등록증 필요, 실호출 미검증 (명세 페이지 기준으로 구현) | |
KISTI | 국가R&D 연구보고서 검색 | ⏸ 활용신청 승인 대기 (승인되면 |
인력 / 채용
기관 | 제공 데이터 | 상태 | 출처 |
국민연금공단 | 회사명으로 사업장 검색 → 가입자수(재직자수 근사치) 및 신규취득·상실 추이 | ✅ 완료 (실호출로 확인) | |
원티드 (Wanted) | 회사 검색 → 회사ID로 채용중 포지션 조회, 직무 키워드 검색 | ⏸ 코드 완료, 키 발급 보류 (OpenAPI 스펙 확인) — 신청 시 사업자등록번호 필수, 팀/회사 명의로 신청해야 해 발급이 미뤄지고 있음 | |
HRD-Net / 고용24 (KDT) | 국민내일배움카드·K-디지털 트레이닝(KDT) 훈련과정 검색 | ⏸ 코드 완료, 키 발급 보류 (work24.go.kr 자체 엔드포인트 명세 확인) — 신청 시 사업자등록번호 필수, 기업회원 전용 서비스라 발급이 미뤄지고 있음 |
Related MCP server: OpenDART MCP Server
인증키 현황
발급처는 15곳이며, 공공데이터포털 키 하나가 gov_search 소스 8곳(+ 국민연금)을 담당합니다. ✅ 발급 완료·정상 동작 / ⏸ 코드는 완료, 키 발급 대기·보류 / ⚠️ 동작은 하지만 조건부(특정 IP·별도 신청 등).
발급처 | 환경변수 | 상태 | 발급 방법 |
금융감독원 OpenDART |
| ✅ | 회원가입 → 인증키 신청, 즉시 |
한국은행 ECOS |
| ✅ | Open API 신청, 즉시~1일 |
통계청 KOSIS |
| ✅ | OpenAPI 활용신청 후 승인 |
공공데이터포털 |
| ✅ | 서비스 상세페이지에서 활용신청 |
한국수출입은행 |
| ✅ | 상품별로 각각 신청, 즉시 |
기업마당 |
| ✅ | 신청서 작성 → 이메일 수신, 1일 |
KIPRIS Plus |
| ✅ | 회원가입 → Open API 인증키 신청, 즉시 |
NEIS |
| ✅ | 회원가입 → 인증키 신청, 즉시. 없어도 동작(5건 제한) |
NTIS |
| ⚠️ 신청자 개인 IP에서만 동작 | 소속기관 등록 + 서버 공인 IP 등록, 승인 수일 — 지금 키는 신청자 개인 공인 IP로만 등록돼 있어 그 사람 PC 외에는 막힌다. 회사 소속기관 정보가 이미 한 계정에 걸려 있어 동료가 별도 계정으로 재신청해도 중복으로 막힐 수 있다. 팀에서 쓰려면 고정 공인 IP 서버를 확보해 그 서버에 배포하고, NTIS 활용신청 관리 페이지에서 기존 키의 등록 IP를 그 고정 IP로 갱신하는 쪽을 권장 (단, IP 변경 후 신청자 개인 PC에서는 안 될 수 있음 — 여러 IP 동시 등록 가능 여부는 NTIS 화면에서 직접 확인) |
서울연구원 |
| ✅ | 신청 폼 제출 → 승인 후 이메일로 키·연동가이드 수신 |
국민연금공단 |
| ✅ | 서비스 상세페이지(3046071)에서 별도 활용신청 완료. 활용신청을 안 하면 같은 키로도 |
원티드 |
| ⏸ 코드 완료, 키 발급 보류 |
|
HRD-Net/고용24 |
| ⏸ 코드 완료, 키 발급 보류 | 기업회원 가입 → Open API 신청(사업자등록번호 필수) → authKey 발급. 회사 명의 신청이 필요해 아직 미발급 |
KCI |
| ⏸ 코드 완료, 키 발급 보류 | openApiList.kci에서 신청 → 서류 심사(사업자등록증 필요) 후 발급. 코드는 완료돼 있어 키만 넣으면 동작 |
공공데이터포털 인증키는 계정당 1개입니다
서비스마다 키가 발급되지 않습니다. 키 1개에 서비스별 사용 권한이 붙는 구조입니다.
서비스를 몇 개 신청하든 .env 에 넣을 값은 하나뿐입니다.
포털이 인증키를 Encoding / Decoding 두 형태로 보여주는데, Decoding 키를 넣어야 합니다.
설치 및 실행
이 서버는 stdio(표준입출력)로 통신합니다. 어딘가에 띄워두고 여러 명이 접속하는 서버가
아니라, Claude Desktop/Code가 이 프로그램을 각자의 컴퓨터에서 직접 실행해서 대화하는
방식입니다. 그래서 쓰려는 사람마다 아래 두 단계(① 실행 환경 준비 → ② Claude에 등록)를
각자 자기 컴퓨터에서 진행해야 하고, .env의 키도 각자 자기 것을 넣어야 합니다.
0. 코드 받기 (git clone)
↓
① 실행 환경 준비 (venv 또는 Docker 중 택1)
↓ (실행 명령 하나가 나옴)
② 그 실행 명령을 Claude Desktop/Code에 등록
↓
도구 사용 가능0. 코드 받기
아직 이 저장소가 없는 컴퓨터라면 먼저 clone합니다 (git이 없다면 git-scm.com에서 먼저 설치).
git clone https://github.com/GeeYun086/korea-public-data-mcp.git
cd korea-public-data-mcp아래 ①·② 의 C:\경로\public-data-mcp 는 이 clone된 폴더의 실제 경로로 바꿔서 씁니다.
① 실행 환경 준비
venv (Python을 직접 설치하는 방식)
python -m venv .venv
.venv/Scripts/pip install -e .
cp .env.example .env # 발급받은 키 입력키가 하나도 없어도 서버는 정상적으로 뜹니다. 키가 필요한 도구를 호출할 때만 발급 안내가 나옵니다.
이 방식의 실행 명령은 C:\경로\public-data-mcp\.venv\Scripts\python.exe -m korea_public_data_mcp.server 입니다.
Docker (Python 설치가 필요 없는 방식)
docker build -t korea-public-data-mcp .stdio 통신이라 포트는 열지 않으며, 인증키는 이미지에 넣지 않고 실행 시점에 .env로 주입합니다.
이 방식의 실행 명령은 docker run -i --rm --env-file C:\경로\public-data-mcp\.env korea-public-data-mcp 입니다
(Claude가 어느 폴더에서 이 명령을 실행할지 알 수 없으므로 --env-file은 상대경로 .env가 아니라
반드시 절대경로로 지정하세요).
venv와 Docker는 둘 중 하나만 고르면 됩니다. 아래 ②에서 등록할 때 어느 쪽을 골랐는지에 따라
command/args만 바뀌고, 나머지는 동일합니다.
② Claude Desktop 또는 Claude Code에 등록
①에서 나온 실행 명령을 아래처럼 등록합니다. venv를 골랐으면 A, Docker를 골랐으면 B를 씁니다.
Claude Desktop
%APPDATA%\Claude\claude_desktop_config.json 의 mcpServers 에 추가한 뒤 앱을 재시작합니다.
A. venv로 준비했다면:
"korea-public-data": {
"command": "C:\\경로\\public-data-mcp\\.venv\\Scripts\\python.exe",
"args": ["-m", "korea_public_data_mcp.server"]
}B. Docker로 준비했다면:
"korea-public-data": {
"command": "docker",
"args": ["run", "-i", "--rm", "--env-file", "C:\\경로\\public-data-mcp\\.env", "korea-public-data-mcp"]
}Claude Code
프로젝트 루트에 .mcp.json 을 만들거나 아래 명령으로 등록합니다.
A. venv로 준비했다면:
claude mcp add korea-public-data -- C:\경로\public-data-mcp\.venv\Scripts\python.exe -m korea_public_data_mcp.serverB. Docker로 준비했다면:
claude mcp add korea-public-data -- docker run -i --rm --env-file C:\경로\public-data-mcp\.env korea-public-data-mcp제공 도구 (25개)
정부사업 · 조달
여러 기관이 같은 성격의 "공고"를 제공하므로 하나의 검색 도구로 묶었습니다.
도구 | 설명 |
| 9개 소스를 한 번에 검색합니다. 기관을 지정하면 그쪽만 조회하고, 지정하지 않으면 전체를 훑되 기관별 상한(기본 10건)을 적용합니다 |
| 조회 가능한 소스 목록과 각 소스의 특성을 반환합니다. |
gov_search 인자
인자 | 설명 |
| 공고명·요약·지원대상·분야·기관명에서 찾을 키워드. 공백으로 나눈 여러 단어는 AND |
| 기관 지정 (예: |
|
|
| 지원대상 (예: |
| 접수 마감된 공고 제외 (기본 |
| 기관별 최대 반환 건수 (기본 10) |
금융
기관마다 데이터 성격이 완전히 달라 개별 도구로 제공합니다.
도구 | 설명 |
| 회사명으로 기업코드를 찾습니다. 다른 DART 도구보다 먼저 호출합니다 |
| 재무제표 전체를 한 번에 조회합니다 (연결 |
| 기간별 공시 목록을 조회합니다 |
| 기준금리·원달러환율·GDP성장률·소비자물가지수를 이름으로 바로 조회합니다 |
| 그 밖의 한국은행 통계표를 검색합니다 |
| 통계표 코드로 실제 수치를 조회합니다 |
| 통계청 통계표를 검색합니다 |
| 통계표를 기간 범위 단위로 일괄 조회합니다 |
| 환율 (매매기준율·전신환매매율) |
| 대출금리 |
| 국제금리 (SOFR·ESTR 등) |
지식재산권 · 교육 · 학술연구
기관마다 데이터 성격이 완전히 달라 개별 도구로 제공합니다.
도구 | 설명 |
| KIPRIS Plus로 국내 특허·실용신안을 키워드로 검색합니다 (발명명칭·초록·출원인 대상). 무료 한도가 월 1,000회로 빠듯합니다 |
| NEIS로 전국 초·중·고·특수학교 기본정보를 조회합니다. 인증키가 없어도 동작하지만 5건으로 제한됩니다 |
| NTIS로 국가 R&D 과제를 키워드로 검색합니다. ⚠️ 지금 키는 신청자 개인 공인 IP로만 등록돼 있어 그 사람 환경에서만 동작합니다 — 팀 공용은 고정 IP 서버 배포 + 등록 IP 갱신 필요 |
| 서울연구원 연구보고서·정책리포트 등 11개 카테고리에서 자료를 검색합니다. 카테고리( |
| KCI(한국학술지인용색인)에 등재된 국내 학술논문을 제목 키워드로 검색합니다. 저자·발행연도로 좁힐 수 있습니다. 키 발급이 보류 중이라 실호출 미검증입니다 |
인력 · 채용
도구 | 설명 |
| 회사명으로 국민연금 사업장을 찾아 가입자수(재직자수 근사치)를 조회합니다 |
| 사업장코드(seq)로 신규취득·상실가입자수(입퇴사 흐름)를 조회합니다. |
| 원티드에 등록된 회사를 이름으로 검색해 회사ID를 얻습니다. ⏸ 코드는 완료됐지만 키 발급이 보류 중입니다 (사업자등록번호 필요) |
| 회사ID로 그 회사가 현재 채용 중인 포지션 목록을 조회합니다. ⏸ 키 발급 보류 중 |
| 직무 키워드로 채용공고를 검색합니다 (특정 회사에 한정하지 않음). ⏸ 키 발급 보류 중 |
| 고용24에서 국민내일배움카드 훈련과정을 검색합니다. K-디지털 트레이닝(KDT)이 기본값입니다. ⏸ 코드는 완료됐지만 키 발급이 보류 중입니다 (사업자등록번호 필요) |
공통
도구 | 설명 |
| 공공데이터포털의 다른 서비스를 호출합니다. 포털에서 활용신청만 하면 코드 수정 없이 사용할 수 있습니다 |
라이선스
각 기관 API의 이용약관과 출처표시 의무를 따릅니다.
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to access the Korean Financial Supervisory Service's OpenDART API for corporate filings, financial statements, and disclosures.613MIT
- AlicenseAqualityDmaintenanceEnables MCP clients like Claude Desktop to search, retrieve, and analyze Korean statistical data from KOSIS OpenAPI.161MIT
- AlicenseAqualityDmaintenanceEnables natural language querying of Korean statistical data from KOSIS, including population, employment, GDP, housing prices, and more, with support for regional and trend analysis.815MIT
Related MCP Connectors
Search company disclosures and financial statements from the Korean market. Retrieve stock profile…
Korean market data for AI agents: K-beauty/K-food products, Naver trends, stocks, real estate.
Access Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeeYun086/korea-public-data-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server