AI导哈

公共数据API协议服务器

将韩国公共数据门户(data.go.kr)的API封装为Model Context Protocol (MCP)服务器，为AI工具提供标准化访问接口。

  • by Koomook
  • Python
  • 本地部署
  • 371 星标
  • 更新于
在 GitHub 查看 Koomook/data-go-mcp-servers

使用说明

韩国Data.go.kr MCP服务器

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

目录

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

类别 服务器名称 说明 包 PyPI
🏢 业务信息 NPS商业注册 查询国民年金公团企业加入信息 data-go-mcp.nps-business-enrollment
🏢 业务信息 NTS业务验证 国税厅运营商注册信息真伪确认和状态查询 data-go-mcp.nts-business-verification
📋 采购/合同 PPS纳拉扬特奥 国家集市招标公告、中标信息、合同信息 data-go-mcp.pps-narajangteo
💰 金融信息 FSC财务信息 金融委员会企业财务信息（财务报表、损益表） data-go-mcp.fsc-financial-info
📜 公共记录 总统演讲 查询总统档案馆演讲稿 data-go-mcp.presidential-speeches
⚗ENT安全信息 MSDS化学信息 物质安全健康资料（MSDS）化学物质信息 data-go-mcp.msds-chemical-info

安装和设置

使用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没有正式关联。使用公共数据时，请查看每个数据的使用条款和条件。

相关 MCP