data-go-mcp-servers: Instructions file for Claude Code

Korea Data.go.kr MCP Servers - Development Guide

이 프로젝트는 한국 공공 데이터 포털(data.go.kr)의 API를 Model Context Protocol (MCP) 서버로 제공합니다.

프로젝트 구조

data-go-mcp-servers/
├── src/                              # MCP 서버들
│   ├── nps-business-enrollment/      # 국민연금공단 사업장 가입 내역
│   ├── nts-business-verification/    # 국세청 사업자등록정보
│   ├── fsc-financial-info/           # 금융감독원 금융회사 정보
│   ├── presidential-speeches/        # 대통령기록관 연설기록
│   ├── pps-narajangteo/              # 조달청 나라장터 정보
│   └── msds-chemical-info/           # 화학물질안전원 MSDS 정보
│       ├── pyproject.toml            # 패키지 설정 (PyPI 배포용)
│       ├── data_go_mcp/
│       │   └── {module_name}/
│       │       ├── server.py         # MCP 서버 구현
│       │       ├── api_client.py     # API 클라이언트
│       │       └── models.py         # 데이터 모델
│       └── tests/                    # 테스트 코드
├── template/                          # Cookiecutter 템플릿
├── scripts/
│   └── deploy_to_pypi.py             # PyPI 배포 자동화 스크립트
├── CONTRIBUTING.md                   # 새 MCP 서버 추가 가이드
├── LICENSE                           # Apache 2.0
└── pyproject.toml                    # UV workspace 설정

개발된 MCP 서버 예시

패키지 구조 예시: nps-business-enrollment

src/nps-business-enrollment/
├── pyproject.toml                    # 패키지 메타데이터 및 의존성
├── data_go_mcp/
│   └── nps_business_enrollment/      # 모듈명은 하이픈(-) 대신 언더스코어(_) 사용
│       ├── __init__.py
│       ├── server.py                 # MCP 서버 엔트리포인트
│       ├── api_client.py             # data.go.kr API 호출 로직
│       └── models.py                 # Pydantic 모델 정의
└── tests/
    ├── __init__.py
    ├── test_api_client.py             # API 클라이언트 단위 테스트
    └── test_models.py                 # 데이터 모델 검증 테스트

중요: 패키지명은 하이픈(-) 사용, 모듈명은 언더스코어(_) 사용

개발 환경 설정

필수 도구

• Python 3.10+
• UV (패키지 매니저)

설치

# 의존성 설치
uv sync --dev

# 특정 서버 개발
cd src/nps-business-enrollment
uv sync

새로운 MCP 서버 추가하기

1. Cookiecutter로 템플릿 생성

# 프로젝트 루트에서 실행
uv run cookiecutter template/ -o src/

# 프롬프트 입력 예시:
# api_name: Weather Forecast              # 사람이 읽기 쉬운 이름
# api_slug: weather-forecast              # URL/디렉토리용 (자동 생성됨)
# package_name: data-go-mcp.weather-forecast  # PyPI 패키지명 (자동 생성됨)
# module_name: weather_forecast           # Python 모듈명 (자동 생성됨)