Data Go MCP Servers

韩国Data.go.kr MCP服务器

该项目将韩国公共数据门户（data.go.kr）API作为Model Context Protocol（MCP）服务器提供。

](https://github.com/Koomook/data-go-mcp-servers)   

目录

• 韩国Data.go.kr MCP服务器

- 目录 - MCP（模型上下文协议）란? - 为什么是韩国公共数据MCP服务器？ - 可用的MCP服务器 - 安装和设置 - 使用UV安装 - 使用pip安装 - Claude桌面设置 - Cline设置 - 每台服务器的使用方法 - 国民年金公团企业加入明细（NPS Business Enrollment） - 国税厅运营商注册信息真伪确认和状态查询（NTS Business Verification） - 开发者指南 - 贡献 - 许可证

MCP（模型上下文协议）란?

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服务器

安装和设置

使用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桌面设置

将MCP服务器添加到Claude Desktop的配置文件：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %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"
      }
    }
  }
}

每台服务器的使用方法

国民年金公团企业加入明细（NPS Business Enrollment）

可以查询加入国民年金的企业信息。

设置环境变量

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）

您可以查看运营商属性的真伪并查看其当前状态。

设置环境变量

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格式：

  [
    {
      "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：增值税简易征税者 - 其他：免税事业者等

开发者指南

设置开发环境

# 레포지토리 클론
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服务器

使用自动化脚本（建议）

最快的方法是使用提供的模板创建脚本：

# 대화형 스크립트 실행
uv run python scripts/create_mcp_server.py

脚本将逐步引导您了解所需的信息，并在几分钟内创建新的MCP服务器。

手动使用模板

# Cookiecutter 설치 (필요시)
uv pip install cookiecutter

# 템플릿으로 새 서버 생성
uv run cookiecutter template/ -o src/

有关使用模板的详细信息，请参阅 模板_USAGE.md请参阅。 整个开发指南 贡献.md请参阅。

运行测试

# 모든 테스트 실행
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

详细指南包括： 贡献.md请参阅。

许可证

此项目在Apache License 2.0许可证下分发。有关详细信息，请访问 许可证 请参考文件。

______________________________________________________________________

请参见：该项目与韩国政府或data.go.kr没有正式关联。使用公共数据时，请查看每个数据的使用条款和条件。