awesome-mcp-korea 공공데이터 서버 목록 — 한국 공공 API MCP 서버 총정리
awesome-mcp-korea에서 찾을 수 있는 한국 공공데이터 MCP 서버를 카테고리별로 총정리합니다. 부동산·국어사전·사업자 조회 등 실제 설치 방법과 API 키 발급까지 한 곳에서 확인하세요.
한국 공공데이터를 AI 도구에 바로 연결하고 싶다면 awesome-mcp-korea 계열의 MCP 서버를 활용하는 것이 가장 빠른 방법입니다. 부동산 실거래가 조회, 사업자 등록 진위 확인, 표준국어대사전 검색 등 다양한 공공 API가 이미 MCP 서버로 패키징되어 있습니다. 이 글에서는 현재 사용 가능한 대표 한국 공공 API MCP 서버들을 카테고리별로 정리하고, 각 서버의 설치 방법과 API 키 준비 과정을 안내합니다.
왜 공공데이터 MCP 서버가 필요한가
대한민국 공공데이터포털(data.go.kr)에는 50,000개가 넘는 공개 API가 등록되어 있습니다. 국토교통부 실거래가부터 국세청 사업자 조회, 조달청 나라장터, 금융감독원 재무정보까지 — 거의 모든 공공 행정 데이터가 OpenAPI로 열려 있습니다.
문제는 연결 비용입니다. API마다 인증키 발급 절차가 다르고, 요청 파라미터 구조가 서로 달라 코드를 직접 작성해야 합니다. 응답 포맷도 XML·JSON이 혼재합니다. 개발자가 아니라면 시작하기 어렵고, 개발자도 반복 작업이 많습니다.
MCP(Model Context Protocol) 서버는 이 장벽을 없애줍니다. 공공 API 호출 로직을 서버 안에 캡슐화해 두면, Claude나 Cursor 같은 AI 도구가 자연어 명령 한 문장으로 API를 호출하고 결과를 해석해 답해줍니다.
사용자 → AI 클라이언트 → MCP 서버 → 한국 공공 API (data.go.kr 등)
↑
인증·파싱 담당
한국 공공 API MCP 서버 목록
현재 실사용이 가능한 대표 서버 세 종류를 정리합니다.
1. 한국 부동산 MCP (real-estate-mcp)
| 항목 | 내용 |
|---|---|
| 저장소 | github.com/tae0y/real-estate-mcp |
| 연결 API | 국토교통부 실거래가 공공데이터, 한국부동산원 청약홈, 한국자산관리공사 온비드 |
| API 키 필요 | 필요 (data.go.kr 발급) |
| 실행 방식 | stdio (직접 실행) |
한국 부동산 MCP는 아파트·오피스텔·빌라 실거래가를 국토교통부 공공데이터로 조회하고, 매수 시나리오를 분석하는 MCP 서버입니다. 청약홈 정보나 온비드 공매 데이터도 함께 다룰 수 있어 부동산 의사결정 자동화에 유용합니다.
API 키 발급: data.go.kr 국토교통부 실거래가 API 페이지에서 활용 신청 후 발급받을 수 있습니다.
설치는 저장소를 클론한 뒤 해당 프로젝트의 설치 안내를 따릅니다. Claude Desktop 설정 예시는 아래와 같습니다.
{
"mcpServers": {
"real-estate-mcp": {
"command": "python",
"args": ["<클론한_경로>/real_estate_mcp/server.py"],
"env": {
"DATA_GO_KR_KEY": "발급받은_서비스키"
}
}
}
}
설정 파일 경로(macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
2. 공공데이터포털 MCP 서버 모음 (data-go-mcp-servers)
| 항목 | 내용 |
|---|---|
| 저장소 | github.com/Koomook/data-go-mcp-servers |
| 연결 API | 국민연금공단 사업장 가입, 국세청 사업자등록 진위 확인, 조달청 나라장터, 금융감독원 기업재무정보, 대통령기록원 연설문, 화학물질안전원 MSDS |
| API 키 필요 | 필요 (data.go.kr 발급) |
| 실행 방식 | uvx |
공공데이터포털 MCP 서버 모음은 data.go.kr의 여러 API를 개별 MCP 서버로 패키징한 컬렉션입니다. 사업자 조회, 나라장터 입찰 정보, 기업 재무제표 등 업무용 데이터를 AI로 바로 다룰 수 있습니다.
현재 공개된 서버 중 국민연금 사업장 가입 정보 서버는 아래 명령으로 바로 실행할 수 있습니다.
uvx data-go-mcp.nps-business-enrollment@latest
Claude Desktop 설정 예시:
{
"mcpServers": {
"data-go-nps": {
"command": "uvx",
"args": ["data-go-mcp.nps-business-enrollment@latest"],
"env": {
"DATA_GO_KR_KEY": "발급받은_서비스키"
}
}
}
}
컬렉션 안에 여러 서버가 포함되어 있으니, 저장소 README에서 각 서버별 환경 변수명과 사용 가능한 도구 목록을 확인하고 필요한 것만 선택해 추가하세요.
3. 표준국어대사전 MCP 서버 (ko-stdict-mcp)
| 항목 | 내용 |
|---|---|
| 저장소 | github.com/dahlia/ko-stdict-mcp |
| 연결 API | 국립국어원 표준국어대사전 (로컬 SQLite 기반) |
| API 키 필요 | 불필요 |
| 실행 방식 | stdio |
표준국어대사전 MCP 서버는 네트워크 API 호출이 아닌, 국립국어원 사전 JSON 덤프를 로컬 SQLite 데이터베이스로 변환해 사용하는 방식입니다. 인터넷 연결 없이도 동작하고, API 키도 필요 없습니다.
한국어 문서 작성 보조, 맞춤법·어휘 확인, 뜻풀이 검색 등 언어 관련 작업에 바로 활용할 수 있습니다. 저장소 README에 따라 사전 데이터 다운로드 및 DB 변환 과정을 먼저 완료한 뒤 서버를 실행합니다.
API 키 발급 공통 절차
data.go.kr 기반 서버들은 모두 동일한 포털에서 인증키를 발급받습니다.
- data.go.kr에 접속해 회원가입 및 로그인합니다.
- 검색창에 사용하려는 API 이름(예: “국민연금 사업장”, “국토교통부 실거래가”)을 입력합니다.
- 검색 결과에서 해당 API 상세 페이지로 들어가 활용신청 버튼을 클릭합니다.
- 신청 목적을 간단히 입력하면 대부분 즉시 자동 승인됩니다.
- 마이페이지 → 오픈API → 개발계정에서 발급된 일반 인증키(서비스키) 를 복사합니다.
- 복사한 키를 MCP 서버 설정의
env항목에 넣습니다.
보안 주의: 서비스 키는 절대 코드나 공개 GitHub 저장소에 직접 포함하지 마세요.
.env파일이나 시스템 환경 변수로 관리하는 것을 권장합니다.
서버 비교 한눈에 보기
| 서버 | 주요 데이터 | API 키 | 설치 방식 |
|---|---|---|---|
| 한국 부동산 MCP | 실거래가, 청약, 공매 | 필요 | 직접 실행 (stdio) |
| 공공데이터포털 MCP 모음 | 사업자, 나라장터, 재무 등 | 필요 | uvx |
| 표준국어대사전 MCP | 국어사전 (로컬 DB) | 불필요 | 직접 실행 (stdio) |
흔한 오류와 해결 방법
“SERVICE_KEY_IS_NOT_REGISTERED_ERROR” 또는 인증 실패
data.go.kr에서 발급한 키를 그대로 붙여 넣었는데도 오류가 나는 경우, 키의 인코딩 형태를 확인하세요. 포털에서는 인코딩된 키와 디코딩된 키 두 가지를 제공합니다. 일반적으로 URL 인코딩이 필요 없는 환경 변수에는 디코딩된 키를 사용합니다.
“command not found: uvx”
uvx는 Python 패키지 관리 도구 uv에 포함된 실행기입니다. pip install uv 또는 공식 설치 스크립트로 uv를 먼저 설치해야 합니다.
curl -LsSf https://astral.sh/uv/install.sh | sh
저장소 클론 후 의존성 설치 오류
각 서버 저장소의 README에 명시된 Python 버전과 의존성 설치 명령을 반드시 따라야 합니다. requirements.txt 또는 pyproject.toml이 있는지 확인하고, 가상 환경 안에서 설치하는 것을 권장합니다.
자주 묻는 질문
awesome-mcp-korea가 무엇인가요?
awesome-mcp-korea는 한국 공공데이터 API를 Claude·Cursor 등 AI 도구에 연결하는 MCP 서버들을 모아 놓은 오픈소스 큐레이션 목록입니다. GitHub에서 누구나 서버를 추가·기여할 수 있습니다.
공공데이터 MCP 서버를 쓰려면 반드시 API 키가 필요한가요?
서버마다 다릅니다. 국토교통부 실거래가·사업자 조회 등 data.go.kr 기반 서버는 API 인증키가 필요하지만, 표준국어대사전 MCP처럼 로컬 데이터베이스를 활용하는 서버는 별도 키 없이 사용할 수 있습니다.
data.go.kr 인증키는 어떻게 발급받나요?
data.go.kr에 회원가입 후 원하는 API 상세 페이지에서 ‘활용신청’을 진행하면 됩니다. 대부분 자동 승인되며, 마이페이지 → 오픈API → 개발계정에서 서비스 키를 확인할 수 있습니다.
MCP 서버를 Claude Desktop에서 어떻게 연결하나요?
Claude Desktop의 설정 파일(macOS 기준 ~/Library/Application Support/Claude/claude_desktop_config.json)에 mcpServers 항목을 추가하고, command·args·env를 지정하면 됩니다. 저장 후 Claude Desktop을 재시작하면 도구가 연결됩니다.
한국 공공데이터 MCP 서버를 MCP모아에서 더 찾을 수 있나요?
네, MCP모아의 공공데이터 카테고리에서 국내 공공 API MCP 서버 전체 목록을 확인할 수 있습니다.
직접 만든 한국 공공데이터 MCP 서버를 등록하려면 어떻게 하나요?
MCP모아 서버 등록 페이지를 통해 신청하거나, awesome-mcp-korea GitHub 저장소에 PR을 올려 기여할 수 있습니다.
다음 단계
한국 공공 API MCP 서버 목록을 파악했다면, 이제 실제로 설치해 보세요. 각 서버 상세 페이지에서 정확한 환경 변수명, 사용 가능한 MCP 도구 목록, 클라이언트별 설치 탭을 확인할 수 있습니다.
- 한국 부동산 MCP 서버 상세 — 실거래가·청약·공매 데이터 AI 연결
- 공공데이터포털 MCP 서버 모음 상세 — 사업자·나라장터·재무 데이터
- 표준국어대사전 MCP 서버 상세 — 오프라인 국어사전 AI 연결
- 공공데이터 카테고리 전체 보기
- 전체 MCP 서버 목록