数据传输MCP服务器

Name: 数据传输MCP服务器
Author: Koomook

作者：Koomook10 星标更新：2025-09-17

安装使用来源：spider==github.com

项目介绍

韩国 Data.go.kr MCP 服务器

韩国公共数据门户(data.go.kr) API 提供的 Model Context Protocol (MCP) 服务器项目。

什么是 MCP (Model Context Protocol)?

Model Context Protocol (MCP) 是一个开放协议，它使得大型语言模型 (LLM) 应用程序能够与外部数据源和工具进行无缝集成。无论是构建基于 AI 的 IDE，改进聊天界面，还是创建自定义 AI 工作流，MCP 都提供了一种标准化的方法来连接 LLM 所需的上下文。

MCP 服务器是轻量级程序，通过 Model Context Protocol 暴露特定功能。AI 工具如 Claude Desktop、Cline、Cursor 和 Windsurf 可以作为 MCP 客户端与这些服务器通信。

为什么是韩国公共数据 MCP 服务器？

韩国政府的公共数据门户(data.go.kr)提供了来自多个公共机构的数据 API。这个项目将这些 API 包装成 MCP 服务器，使 AI 工具能够轻松访问和利用韩国的公共数据。

主要优势：

标准化访问：通过统一的 MCP 接口使用多种公共 API。
AI 工具集成：在 Claude、Cline 等 AI 工具中直接使用公共数据。
简易安装：可以通过 pip 或 uv 轻松安装。
类型稳定性：使用 Pydantic 进行强大的类型验证。

可用的 MCP 服务器

类别	服务器名称	描述	包名
🏢 商业信息	NPS Business Enrollment	国民年金公团事业场所加入信息查询	`data-go-mcp.nps-business-enrollment`
🏢 商业信息	NTS Business Verification	国税厅事业者登记信息真伪确认及状态查询	`data-go-mcp.nts-business-verification`
📋 政府采购/合同	PPS Narajangteo	国家市场投标公告、中标信息、合同信息	`data-go-mcp.pps-narajangteo`
💰 金融信息	FSC Financial Info	金融委员会企业财务信息（财务报表、损益表）	`data-go-mcp.fsc-financial-info`
📜 公共记录	Presidential Speeches	总统记录馆演讲词查询	`data-go-mcp.presidential-speeches`
⚗️ 安全信息	MSDS Chemical Info	物质安全卫生资料(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 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"
      }
    }
  }
}

各服务器的使用方法

国民年金公团事业场所加入记录 (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/

有关模板使用的详细信息，请参阅 TEMPLATE_USAGE.md。有关完整的开发指南，请参阅 CONTRIBUTING.md。

运行测试

# 运行所有测试
uv run pytest

# 运行特定服务器的测试
uv run pytest src/nps-business-enrollment/tests/

贡献指南

如果您想为此项目做出贡献：

Fork 此仓库
创建新功能分支 (git checkout -b feature/new-api-server)
提交更改 (git commit -am 'Add new API server')
将分支推送到远程 (git push origin feature/new-api-server)
打开 Pull Request

有关详细的贡献指南，请参阅 CONTRIBUTING.md。

许可证

此项目根据 Apache License 2.0 发布。详情请参阅 LICENSE 文件。

注意：此项目与韩国政府或 data.go.kr 没有正式关联。使用公共数据时，请务必查阅每个数据的使用条款。

数据传输MCP服务器

项目介绍

韩国 Data.go.kr MCP 服务器

目录

什么是 MCP (Model Context Protocol)?

为什么是韩国公共数据 MCP 服务器？

可用的 MCP 服务器

安装与设置

使用 UV 安装

使用 pip 安装

Claude Desktop 设置

Cline 设置

各服务器的使用方法

国民年金公团事业场所加入记录 (NPS Business Enrollment)

环境变量设置

可用工具

使用示例

国税厅事业者登记信息真伪确认及状态查询 (NTS Business Verification)

环境变量设置

可用工具

使用示例

状态代码说明

开发者指南

开发环境设置

🚀 快速创建新的 MCP 服务器

使用自动化脚本 (推荐)

手动使用模板

运行测试

贡献指南

许可证