data-go-mcp-servers
Korea public data portal (data.go.kr) API MCP servers
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/koomook--data-go-mcp-servers)HTML
<a href="/listings/koomook--data-go-mcp-servers"><img src="/api/listings/koomook--data-go-mcp-servers/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
UV를 사용한 설치
# 비즈니스 정보 서버 uv pip install data-go-mcp.nps-business-enrollment uv pip install data-go-mcp.nts-business-verification # 조달/계약 서버 uv pip install data-go-mcp.pps-narajangteo # 금융 정보 서버 uv pip install data-go-mcp.fsc-financial-info # 공공 기록 서버 uv pip install data-go-mcp.presidential-speeches # 안전 정보 서버 uv pip install data-go-mcp.msds-chemical-info
pip을 사용한 설치
# 비즈니스 정보 서버 pip install data-go-mcp.nps-business-enrollment pip install data-go-mcp.nts-business-verification # 조달/계약 서버 pip install data-go-mcp.pps-narajangteo # 금융 정보 서버 pip install data-go-mcp.fsc-financial-info # 공공 기록 서버 pip install data-go-mcp.presidential-speeches # 안전 정보 서버 pip install data-go-mcp.msds-chemical-info
Claude Desktop 설정
Claude Desktop의 설정 파일에 MCP 서버를 추가합니다:
**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
{
"mcpServers": {
"data-go-mcp.nps-business-enrollment": {
"command": "uvx",
"args": ["data-go-mcp.nps-business-enrollment@latest"],
"env": {
"API_KEY": "your-api-key-here"
}
},
"data-go-mcp.nts-business-verification": {
"command": "uvx",
"args": ["data-go-mcp.nts-business-verification@latest"],
"env": {
"API_KEY": "your-api-key-here"
}
},
"data-go-mcp.pps-narajangteo": {
"command": "uvx",
"args": ["data-go-mcp.pps-narajangteo@latest"],
"env": {
"API_KEY": "your-api-key-here"
}
},
"data-go-mcp.fsc-financial-info": {
"command": "uvx",
"args": ["data-go-mcp.fsc-financial-info@latest"],
"env": {
"API_KEY": "your-api-key-here"
}
},
"data-go-mcp.presidential-speeches": {
"command": "uvx",
"args": ["data-go-mcp.presidential-speeches@latest"],
"env": {
"API_KEY": "your-api-key-here"
}
},
"data-go-mcp.msds-chemical-info": {
"command": "uvx",
"args": ["data-go-mcp.msds-chemical-info@latest"],
"env": {
"API_KEY": "your-api-key-here"
}
}
}
}**참고**: `@latest`를 사용하면 항상 최신 버전이 실행됩니다.
Cline 설정
VS Code의 Cline 확장에서 MCP 서버를 설정합니다:
`.vscode/cline_mcp_settings.json`:
{
"mcpServers": {
"data-go-mcp.nps-business-enrollment": {
"command": "python",
"args": ["-m", "data_go_mcp.nps_business_enrollment.server"],
"env": {
"API_KEY": "your-api-key-here"
}
}
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 349 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Korea Data.go.kr MCP Servers
- 한국 공공 데이터 포털(data.go.kr) API를 Model Context Protocol (MCP) 서버로 제공하는 프로젝트입니다.
- [](https://github.com/Koomook/data-go-mcp-servers)
- [](https://pypi.org/project/data-go-mcp.nps-business-enrollment/)
- [](LICENSE)
- [](https://www.python.org/)
- ## 목차
- - [Korea Data.go.kr MCP Servers](#korea-datagokr-mcp-servers)
- - [목차](#목차)
- - [MCP (Model Context Protocol)란?](#mcp-model-context-protocol란)
- - [왜 한국 공공 데이터 MCP 서버인가?](#왜-한국-공공-데이터-mcp-서버인가)
- - [사용 가능한 MCP 서버](#사용-가능한-mcp-서버)
- - [설치 및 설정](#설치-및-설정)
- - [UV를 사용한 설치](#uv를-사용한-설치)
- - [pip을 사용한 설치](#pip을-사용한-설치)
- - [Claude Desktop 설정](#claude-desktop-설정)
- - [Cline 설정](#cline-설정)
- - [각 서버별 사용법](#각-서버별-사용법)
- - [국민연금공단 사업장 가입 내역 (NPS Business Enrollment)](#국민연금공단-사업장-가입-내역-nps-business-enrollment)
- - [국세청 사업자등록정보 진위확인 및 상태조회 (NTS Business Verification)](#국세청-사업자등록정보-진위확인-및-상태조회-nts-business-verification)
- - [개발자 가이드](#개발자-가이드)
- - [기여하기](#기여하기)
- - [라이센스](#라이센스)
- ## MCP (Model Context Protocol)란?
- Model Context Protocol (MCP)은 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 개방형 프로토콜입니다. AI 기반 IDE를 구축하든, 채팅 인터페이스를 향상시키든, 사용자 정의 AI 워크플로우를 만들든, MCP는 LLM이 필요한 컨텍스트와 연결하는 표준화된 방법을 제공합니다.
- MCP 서버는 Model Context Protocol을 통해 특정 기능을 노출하는 경량 프로그램입니다. Claude Desktop, Cline, Cursor, Windsurf 등의 AI 도구들이 MCP 클라이언트로서 이러한 서버와 통신할 수 있습니다.
- ## 왜 한국 공공 데이터 MCP 서버인가?
- 한국 정부의 공공 데이터 포털(data.go.kr)은 다양한 공공 기관의 데이터를 API로 제공합니다. 이 프로젝트는 이러한 API들을 MCP 서버로 래핑하여, AI 도구들이 한국 공공 데이터에 쉽게 접근하고 활용할 수 있도록 합니다.
- 주요 이점:
- - **표준화된 접근**: 다양한 공공 API를 통일된 MCP 인터페이스로 사용
- - **AI 도구 통합**: Claude, Cline 등 AI 도구에서 직접 공공 데이터 활용
- - **간편한 설치**: pip 또는 uv로 쉽게 설치 가능
- - **타입 안정성**: Pydantic을 사용한 강력한 타입 검증
- ## 사용 가능한 MCP 서버
- | 카테고리 | 서버명 | 설명 | 패키지 | PyPI |
- |----------|--------|------|--------|------|
- | **🏢 비즈니스 정보** | **NPS Business Enrollment** | 국민연금공단 사업장 가입 정보 조회 | `data-go-mcp.nps-business-enrollment` | [](https://pypi.org/project/data-go-mcp.nps-business-enrollment/) |
- | **🏢 비즈니스 정보** | **NTS Business Verification** | 국세청 사업자등록정보 진위확인 및 상태조회 | `data-go-mcp.nts-business-verification` | [](https://pypi.org/project/data-go-mcp.nts-business-verification/) |
- | **📋 조달/계약** | **PPS Narajangteo** | 나라장터 입찰공고, 낙찰정보, 계약정보 | `data-go-mcp.pps-narajangteo` | [](https://pypi.org/project/data-go-mcp.pps-narajangteo/) |
- | **💰 금융 정보** | **FSC Financial Info** | 금융위원회 기업 재무정보 (재무제표, 손익계산서) | `data-go-mcp.fsc-financial-info` | [](https://pypi.org/project/data-go-mcp.fsc-financial-info/) |
- | **📜 공공 기록** | **Presidential Speeches** | 대통령기록관 연설문 조회 | `data-go-mcp.presidential-speeches` | [](https://pypi.org/project/data-go-mcp.presidential-speeches/) |
- | **⚗️ 안전 정보** | **MSDS Chemical Info** | 물질안전보건자료(MSDS) 화학물질 정보 | `data-go-mcp.msds-chemical-info` | [](https://pypi.org/project/data-go-mcp.msds-chemical-info/) |
- ## 설치 및 설정
- ### UV를 사용한 설치
- ```bash
- # 비즈니스 정보 서버
- uv pip install data-go-mcp.nps-business-enrollment
- uv pip install data-go-mcp.nts-business-verification
- # 조달/계약 서버
- uv pip install data-go-mcp.pps-narajangteo
- # 금융 정보 서버
- uv pip install data-go-mcp.fsc-financial-info
- # 공공 기록 서버
- uv pip install data-go-mcp.presidential-speeches
- # 안전 정보 서버
- uv pip install data-go-mcp.msds-chemical-info
- ```
- ### pip을 사용한 설치
- ```bash
- # 비즈니스 정보 서버
- pip install data-go-mcp.nps-business-enrollment
- pip install data-go-mcp.nts-business-verification
- # 조달/계약 서버
- pip install data-go-mcp.pps-narajangteo
- # 금융 정보 서버
- pip install data-go-mcp.fsc-financial-info
- # 공공 기록 서버
- pip install data-go-mcp.presidential-speeches
- # 안전 정보 서버
- pip install data-go-mcp.msds-chemical-info
- ```
- ### Claude Desktop 설정
- Claude Desktop의 설정 파일에 MCP 서버를 추가합니다:
- **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- ```json
- {
- "mcpServers": {
- "data-go-mcp.nps-business-enrollment": {
- "command": "uvx",
- "args": ["data-go-mcp.nps-business-enrollment@latest"],
- "env": {
- "API_KEY": "your-api-key-here"
- }
- },
- "data-go-mcp.nts-business-verification": {
- "command": "uvx",
- "args": ["data-go-mcp.nts-business-verification@latest"],
- "env": {
- "API_KEY": "your-api-key-here"
- }
- },
- "data-go-mcp.pps-narajangteo": {
- "command": "uvx",
- "args": ["data-go-mcp.pps-narajangteo@latest"],
- "env": {
- "API_KEY": "your-api-key-here"
- }
- },
- "data-go-mcp.fsc-financial-info": {
- "command": "uvx",
- "args": ["data-go-mcp.fsc-financial-info@latest"],
- "env": {
- "API_KEY": "your-api-key-here"
- }
- },
- "data-go-mcp.presidential-speeches": {
- "command": "uvx",
- "args": ["data-go-mcp.presidential-speeches@latest"],
- "env": {
- "API_KEY": "your-api-key-here"
- }
- },
- "data-go-mcp.msds-chemical-info": {
- "command": "uvx",
- "args": ["data-go-mcp.msds-chemical-info@latest"],
- "env": {
- "API_KEY": "your-api-key-here"
- }
- }
- }
- }
- ```
- **참고**: `@latest`를 사용하면 항상 최신 버전이 실행됩니다.
- ### Cline 설정
- VS Code의 Cline 확장에서 MCP 서버를 설정합니다:
- `.vscode/cline_mcp_settings.json`:
- ```json
- {
- "mcpServers": {
- "data-go-mcp.nps-business-enrollment": {
- "command": "python",
- "args": ["-m", "data_go_mcp.nps_business_enrollment.server"],
- "env": {
- "API_KEY": "your-api-key-here"
- }
- }
- }
- }
- ```
- ## 각 서버별 사용법
- ### 국민연금공단 사업장 가입 내역 (NPS Business Enrollment)
- 국민연금에 가입된 사업장 정보를 조회할 수 있습니다.
- #### 환경 변수 설정
- ```bash
- export API_KEY="your-api-key-here" # data.go.kr에서 발급받은 API 키
- ```
- #### 사용 가능한 도구
- **`search_business`**: 사업장 정보 검색
- - 파라미터:
- - `ldong_addr_mgpl_dg_cd`: 법정동주소 광역시도 코드 (2자리)
- - `ldong_addr_mgpl_sggu_cd`: 법정동주소 시군구 코드 (5자리)
- - `ldong_addr_mgpl_sggu_emd_cd`: 법정동주소 읍면동 코드 (8자리)
- - `wkpl_nm`: 사업장명
- - `bzowr_rgst_no`: 사업자등록번호 (앞 6자리)
- - `page_no`: 페이지 번호 (기본값: 1)
- - `num_of_rows`: 한 페이지 결과 수 (기본값: 100, 최대: 100)
- #### 사용 예시
- AI 도구에서 다음과 같이 요청할 수 있습니다:
- ```
- "서울특별시 강남구에 있는 사업장을 검색해줘"
- "삼성전자 사업장 정보를 찾아줘"
- "사업자등록번호 123456으로 시작하는 사업장을 조회해줘"
- ```
- ### 국세청 사업자등록정보 진위확인 및 상태조회 (NTS Business Verification)
- 사업자등록정보의 진위를 확인하고 현재 상태를 조회할 수 있습니다.
- #### 환경 변수 설정
- ```bash
- export API_KEY="your-api-key-here" # data.go.kr에서 발급받은 API 키
- ```
- #### 사용 가능한 도구
- **`validate_business`**: 사업자등록정보 진위확인
- - 파라미터:
- - `business_number`: 사업자등록번호 (10자리, 필수)
- - `start_date`: 개업일자 (YYYYMMDD 형식, 필수)
- - `representative_name`: 대표자성명 (필수)
- - `representative_name2`: 대표자성명2 (외국인 한글명)
- - `business_name`: 상호
- - `corp_number`: 법인등록번호 (13자리)
- - `business_sector`: 주업태명
- - `business_type`: 주종목명
- - `business_address`: 사업장주소
- **`check_business_status`**: 사업자등록 상태조회
- - 파라미터:
- - `business_numbers`: 사업자등록번호 목록 (쉼표로 구분, 최대 100개)
- - 반환값:
- - 사업자 상태: 계속사업자(01), 휴업자(02), 폐업자(03)
- - 과세유형: 일반과세자, 간이과세자 등
- - 폐업일, 과세유형 전환일 등
- **`batch_validate_businesses`**: 대량 진위확인
- - 파라미터:
- - `businesses_json`: JSON 형식의 사업자 정보 배열 (최대 100개)
- - JSON 형식:
- ```json
- [
- {
- "b_no": "1234567890",
- "start_dt": "20200101",
- "p_nm": "홍길동",
- "b_nm": "테스트회사"
- }
- ]
- ```
- #### 사용 예시
- AI 도구에서 다음과 같이 요청할 수 있습니다:
- ```
- "사업자등록번호 123-45-67890이 2020년 1월 1일에 홍길동 대표로 등록된 것이 맞는지 확인해줘"
- "사업자등록번호 123-45-67890의 현재 상태를 조회해줘"
- "여러 사업자등록번호 123-45-67890, 098-76-54321의 상태를 한번에 확인해줘"
- ```
- #### 상태 코드 설명
- - **사업자 상태 코드**:
- - `01`: 계속사업자 (정상 영업중)
- - `02`: 휴업자 (일시적 휴업)
- - `03`: 폐업자 (사업 종료)
- - **과세유형 코드**:
- - `01`: 부가가치세 일반과세자
- - `02`: 부가가치세 간이과세자
- - 기타: 면세사업자 등
- ## 개발자 가이드
- ### 개발 환경 설정
- ```bash
- # 레포지토리 클론
- git clone https://github.com/Koomook/data-go-mcp-servers.git
- cd data-go-mcp-servers
- # UV 설치
- curl -LsSf https://astral.sh/uv/install.sh | sh
- # 개발 의존성 설치
- uv sync --dev
- ```
- ### 🚀 새로운 MCP 서버 빠르게 만들기
- #### 자동화 스크립트 사용 (권장)
- 가장 빠른 방법은 제공된 템플릿 생성 스크립트를 사용하는 것입니다:
- ```bash
- # 대화형 스크립트 실행
- uv run python scripts/create_mcp_server.py
- ```
- 스크립트가 필요한 정보를 단계별로 안내하며, 몇 분 안에 새로운 MCP 서버를 생성합니다.
- #### 수동으로 템플릿 사용
- ```bash
- # Cookiecutter 설치 (필요시)
- uv pip install cookiecutter
- # 템플릿으로 새 서버 생성
- uv run cookiecutter template/ -o src/
- ```
- 자세한 템플릿 사용법은 [TEMPLATE_USAGE.md](TEMPLATE_USAGE.md)를 참조하세요.
- 전체 개발 가이드는 [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요.
- ### 테스트 실행
- ```bash
- # 모든 테스트 실행
- uv run pytest
- # 특정 서버 테스트
- uv run pytest src/nps-business-enrollment/tests/
- ```
- ## 기여하기
- 이 프로젝트에 기여하고 싶으시다면:
- 1. 이 레포지토리를 포크하세요
- 2. 새로운 기능 브랜치를 만드세요 (`git checkout -b feature/new-api-server`)
- 3. 변경사항을 커밋하세요 (`git commit -am 'Add new API server'`)
- 4. 브랜치에 푸시하세요 (`git push origin feature/new-api-server`)
- 5. Pull Request를 열어주세요
- 자세한 가이드는 [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요.
- ## 라이센스
- 이 프로젝트는 Apache License 2.0 라이센스 하에 배포됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
- ---
- **참고**: 이 프로젝트는 한국 정부나 data.go.kr와 공식적으로 연관되어 있지 않습니다. 공공 데이터 사용 시 각 데이터의 이용약관을 확인하시기 바랍니다.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.