Content
# Korea Data.go.kr MCP Servers
This project provides Model Context Protocol (MCP) servers for the Korean public data portal (data.go.kr) API.
[](https://github.com/Koomook/data-go-mcp-servers)
[](https://pypi.org/project/data-go-mcp.nps-business-enrollment/)
[](LICENSE)
[](https://www.python.org/)
## Table of Contents
- [Korea Data.go.kr MCP Servers](#korea-datagokr-mcp-servers)
- [Table of Contents](#table-of-contents)
- [What is MCP (Model Context Protocol)?](#what-is-mcp-model-context-protocol)
- [Why Korea Data.go.kr MCP Servers?](#why-korea-datagokr-mcp-servers)
- [Available MCP Servers](#available-mcp-servers)
- [Installation and Setup](#installation-and-setup)
- [Installation using UV](#installation-using-uv)
- [Installation using pip](#installation-using-pip)
- [Claude Desktop Setup](#claude-desktop-setup)
- [Cline Setup](#cline-setup)
- [Usage for Each Server](#usage-for-each-server)
- [National Pension Service Business Enrollment (NPS Business Enrollment)](#national-pension-service-business-enrollment-nps-business-enrollment)
- [National Tax Service Business Verification (NTS Business Verification)](#national-tax-service-business-verification-nts-business-verification)
- [Developer Guide](#developer-guide)
- [Contributing](#contributing)
- [License](#license)
## What is MCP (Model Context Protocol)?
Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing chat interfaces, or creating custom AI workflows, MCP provides a standardized way for LLMs to connect with the context they need.
MCP servers are lightweight programs that expose specific functionalities through the Model Context Protocol. AI tools like Claude Desktop, Cline, Cursor, and Windsurf can communicate with these servers as MCP clients.
## Why Korea Data.go.kr MCP Servers?
The Korean government's public data portal (data.go.kr) provides APIs for various public data. This project wraps these APIs as MCP servers, allowing AI tools to easily access and utilize Korean public data.
Key benefits:
- **Standardized access**: Use diverse public APIs with a unified MCP interface
- **AI tool integration**: Directly utilize public data in AI tools like Claude and Cline
- **Easy installation**: Installable via pip or uv
- **Type safety**: Strong type validation using Pydantic
## Available MCP Servers
| Category | Server Name | Description | Package | PyPI |
|----------|--------|------|--------|------|
| **🏢 Business Information** | **NPS Business Enrollment** | National Pension Service business enrollment information | `data-go-mcp.nps-business-enrollment` | [](https://pypi.org/project/data-go-mcp.nps-business-enrollment/) |
| **🏢 Business Information** | **NTS Business Verification** | National Tax Service business registration information verification and status inquiry | `data-go-mcp.nts-business-verification` | [](https://pypi.org/project/data-go-mcp.nts-business-verification/) |
| **📋 Procurement/Contract** | **PPS Narajangteo** | Nara Jangter procurement bid announcements, bid information, contract information | `data-go-mcp.pps-narajangteo` | [](https://pypi.org/project/data-go-mcp.pps-narajangteo/) |
| **💰 Financial Information** | **FSC Financial Info** | Financial Services Commission corporate financial information (financial statements, income statements) | `data-go-mcp.fsc-financial-info` | [](https://pypi.org/project/data-go-mcp.fsc-financial-info/) |
| **📜 Public Records** | **Presidential Speeches** | Presidential Archives speech inquiry | `data-go-mcp.presidential-speeches` | [](https://pypi.org/project/data-go-mcp.presidential-speeches/) |
| **⚗️ Safety Information** | **MSDS Chemical Info** | Material Safety Data Sheets (MSDS) chemical substance information | `data-go-mcp.msds-chemical-info` | [](https://pypi.org/project/data-go-mcp.msds-chemical-info/) |
## Installation and Setup
### Installation using UV
```bash
# Business Information Servers
uv pip install data-go-mcp.nps-business-enrollment
uv pip install data-go-mcp.nts-business-verification
# Procurement/Contract Server
uv pip install data-go-mcp.pps-narajangteo
# Financial Information Server
uv pip install data-go-mcp.fsc-financial-info
# Public Records Server
uv pip install data-go-mcp.presidential-speeches
# Safety Information Server
uv pip install data-go-mcp.msds-chemical-info
```
### Installation using pip
```bash
# Business Information Servers
pip install data-go-mcp.nps-business-enrollment
pip install data-go-mcp.nts-business-verification
# Procurement/Contract Server
pip install data-go-mcp.pps-narajangteo
# Financial Information Server
pip install data-go-mcp.fsc-financial-info
# Public Records Server
pip install data-go-mcp.presidential-speeches
# Safety Information Server
pip install data-go-mcp.msds-chemical-info
```
### Claude Desktop Setup
Add the MCP server to Claude Desktop's configuration file:
**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"
}
}
}
}
```
**Note**: Using `@latest` ensures the latest version is executed.
### Cline Setup
Configure the MCP server in the Cline extension for VS Code:
`.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"
}
}
}
}
```
## Usage for Each Server
### National Pension Service Business Enrollment (NPS Business Enrollment)
Inquire about business information enrolled in the National Pension Service.
#### Environment Variable Setup
```bash
export API_KEY="your-api-key-here" # API key issued by data.go.kr
```
#### Available Tools
**`search_business`**: Search for business information
- Parameters:
- `ldong_addr_mgpl_dg_cd`: Administrative district code (2 digits)
- `ldong_addr_mgpl_sggu_cd`: Administrative district code (5 digits)
- `ldong_addr_mgpl_sggu_emd_cd`: Administrative district code (8 digits)
- `wkpl_nm`: Business name
- `bzowr_rgst_no`: Business registration number (first 6 digits)
- `page_no`: Page number (default: 1)
- `num_of_rows`: Number of results per page (default: 100, max: 100)
#### Example Usage
You can request AI tools as follows:
```
"Search for businesses in Gangnam-gu, Seoul"
"Find Samsung Electronics business information"
"Query businesses starting with business registration number 123456"
```
### National Tax Service Business Verification (NTS Business Verification)
Verify business registration information and inquire about the current status.
#### Environment Variable Setup
```bash
export API_KEY="your-api-key-here" # API key issued by data.go.kr
```
#### Available Tools
**`validate_business`**: Verify business registration information
- Parameters:
- `business_number`: Business registration number (10 digits, required)
- `start_date`: Business start date (YYYYMMDD format, required)
- `representative_name`: Representative name (required)
- `representative_name2`: Representative name 2 (foreign name)
- `business_name`: Business name
- `corp_number`: Corporation registration number (13 digits)
- `business_sector`: Main business type
- `business_type`: Main business item
- `business_address`: Business address
**`check_business_status`**: Inquiry about business registration status
- Parameters:
- `business_numbers`: List of business registration numbers (separated by commas, up to 100)
- Return values:
- Business status: Active (01), Temporary closure (02), Closure (03)
- Tax type: General taxpayer, Simple taxpayer, etc.
- Closure date, tax type change date, etc.
**`batch_validate_businesses`**: Mass verification
- Parameters:
- `businesses_json`: JSON format business information array (up to 100)
- JSON format:
```json
[
{
"b_no": "1234567890",
"start_dt": "20200101",
"p_nm": "Hong Gil-dong",
"b_nm": "Test Company"
}
]
```
#### Example Usage
You can request AI tools as follows:
```
"Verify if business registration number 123-45-67890 was registered on January 1, 2020, with representative Hong Gil-dong"
"Check the current status of business registration number 123-45-67890"
"Verify the status of multiple business registration numbers 123-45-67890, 098-76-54321 at once"
```
#### Status Code Explanation
- **Business Status Code**:
- `01`: Active business (normally operating)
- `02`: Temporary closure (temporary suspension)
- `03`: Closure (business termination)
- **Tax Type Code**:
- `01`: General VAT taxpayer
- `02`: Simple VAT taxpayer
- Others: Exempt taxpayer, etc.
## Developer Guide
### Development Environment Setup
```bash
# Clone repository
git clone https://github.com/Koomook/data-go-mcp-servers.git
cd data-go-mcp-servers
# Install UV
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install development dependencies
uv sync --dev
```
### 🚀 Create a New MCP Server Quickly
#### Use Automation Script (Recommended)
The fastest way is to use the provided template generation script:
```bash
# Run interactive script
uv run python scripts/create_mcp_server.py
```
The script guides you through the necessary information step-by-step and creates a new MCP server in a few minutes.
#### Use Template Manually
```bash
# Install Cookiecutter (if needed)
uv pip install cookiecutter
# Create new server with template
uv run cookiecutter template/ -o src/
```
See [TEMPLATE_USAGE.md](TEMPLATE_USAGE.md) for detailed template usage.
Refer to [CONTRIBUTING.md](CONTRIBUTING.md) for the full development guide.
### Run Tests
```bash
# Run all tests
uv run pytest
# Test specific server
uv run pytest src/nps-business-enrollment/tests/
```
## Contributing
To contribute to this project:
1. Fork this repository
2. Create a new branch (`git checkout -b feature/new-api-server`)
3. Commit changes (`git commit -am 'Add new API server'`)
4. Push to the branch (`git push origin feature/new-api-server`)
5. Open a Pull Request
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
## License
This project is distributed under the Apache License 2.0. See [LICENSE](LICENSE) for details.
**Note**: This project is not officially affiliated with the Korean government or data.go.kr. Please check the usage guidelines for each data source when using public data.
