data-go-mcp-servers

한국 공공데이터 API 를 MCP(Model Context Protocol) 서버로 제공한다. Claude Desktop, Claude Code 등 MCP 클라이언트에서 국민연금 사업장과 고용·산재보험 현황, 사업자등록 상태, 나라장터 입찰, 기업 재무제표·법인번호·주식시세, 대통령 연설문, MSDS 화학물질 정보를 바로 조회할 수 있다.

Koomook/data-go-mcp-servers(Apache-2.0, 2025-09 이후 정지)를 기반으로 mcp SDK 2.x 에 맞춰 재정비한 것이다. 툴 이름과 파라미터는 원저장소와 호환된다.

서버

서버 6개, 툴 31개, 공공 API 10종. 모든 툴은 조회 전용이며, 실패는 MCP 오류 결과(isError)로 전달된다. 한 서버가 API 여러 개를 쓰는 경우(nps 3, fsc 3)는 각각 활용신청이 필요하다 — 표는 api-keys.md.

Related MCP server: korea-business-verify

빠른 시작

1. uv 설치

2. data.go.kr 인증키(Decoding) 발급 후 쓰려는 API 에 활용신청 → docs/guide/api-keys.md

3. Claude Desktop 설정(claude_desktop_config.json)에 추가:

{
  "mcpServers": {
    "nts-business-verification": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/hichang4u/data-go-mcp-servers#subdirectory=src/nts-business-verification",
        "data-go-mcp.nts-business-verification"
      ],
      "env": { "API_KEY": "<data.go.kr 인증키>" }
    }
  }
}

다른 서버는 nts-business-verification 을 서버명으로 바꾸면 된다. Claude Code, Cline, clone 해서 쓰는 방법은 docs/guide/installation.md.

> 사업자등록번호 120-88-00767 상태 조회해줘
계속사업자, 부가가치세 일반과세자 …

문서

개발

git clone https://github.com/hichang4u/data-go-mcp-servers && cd data-go-mcp-servers
uv sync --dev --all-packages
uv run pytest                                   # 263 tests; 실호출은 .env 에 API_KEY 를 두고 -m integration
uv run ruff check src scripts tests && uv run pyright src scripts tests
uv run python scripts/check_apis.py             # 10개 API 생존·권한 확인

Python 3.10+, mcp>=2.2. CI 는 ubuntu/windows × 3.10/3.13 에서 pytest, ruff, pyright 를 필수로 돌린다.

라이선스

Apache-2.0. 원저작물 저작권 표시는 NOTICE 와 각 패키지의 LICENSE 에 유지한다. 이 프로젝트는 data.go.kr 및 각 기관과 무관하며, 데이터 이용은 각 API 의 이용약관을 따른다.