공공데이터 MCP 서버 — 사업자등록 상태조회·공휴일·주소·실거래가
공공데이터포털과 도로명주소 API를 MCP로 연결해, AI 에이전트가 국세청 사업자등록 상태(계속·휴업·폐업), 공휴일, 도로명주소 검색, 아파트 매매 실거래가를 조회할 수 있게 해 주는 무료 오픈소스 서버입니다.
@appmonster/mcp-public-data무료 · MIT 오픈소스GitHub →
무엇을 할 수 있나
| 도구 | 하는 일 |
|---|---|
kr_check_business | 사업자등록 상태(계속·휴업·폐업)·과세유형 조회 |
kr_holidays | 공휴일 조회(천문연) |
kr_search_address | 도로명주소 검색 |
kr_apt_trades | 아파트 매매 실거래가 |
설치 (1분)
Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.
Claude Desktop · Cursor · Windsurf
MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.
{
"mcpServers": {
"public-data": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-public-data"
]
}
}
}Claude Code
claude mcp add public-data -- npx -y @appmonster/mcp-public-data필요한 키와 발급처
- 선택
DATA_GO_KR_KEY— 공공데이터포털 인증키(사업자·공휴일·실거래가)- 선택
JUSO_KEY— 도로명주소 API 승인키
발급: 공공데이터포털. 공공데이터포털에서 '국세청 사업자등록정보 진위확인 및 상태조회' 등을 활용신청하면 인증키가 나옵니다. 주소는 business.juso.go.kr에서 따로 받습니다.
이렇게 시켜 보세요
- “이 사업자번호 세 개 지금 정상 영업 중인지 확인해줘.”
- “다음 달 공휴일이랑 대체공휴일 알려줘.”
- “송도동 아파트 지난달 실거래가 평균 내줘.”
자주 묻는 질문
사업자 상태조회는 무료인가요?
네. 공공데이터포털 활용신청은 무료이며 보통 바로 또는 1~2시간 안에 승인됩니다.
키 하나로 다 되나요?
사업자·공휴일·실거래가는 공공데이터포털 키 하나, 주소 검색은 도로명주소 키가 따로 필요합니다. 필요한 것만 넣어도 됩니다.
거래처 확인 후 세금계산서까지 이어서 되나요?
팝빌 서버를 함께 연결하면 '사업자 상태 확인 → 세금계산서 발행'을 한 번에 시킬 수 있습니다.