关键词

韩国公共数据LLM工具API封装财务报表化学品安全

项目简介

'data-go-mcp-servers' 是一个将韩国公共数据门户 (data.go.kr) 提供的各类API转换为Model Context Protocol (MCP) 服务器的项目集合。它旨在为大型语言模型 (LLM) 应用程序提供一个标准化、便捷的方式来访问和利用丰富的韩国公共数据，例如企业财务信息、化学品安全数据、总统演讲记录、国民年金事业场信息和国家税务局商业登记信息等。

主要功能点

  • 多样化数据集成: 封装了国民年金、国税厅、金融委员会、国家记录院、工业安全保健公团（MSDS）和国家采购局等多个公共机构的数据API。
  • LLM原生兼容: 通过MCP协议，LLM应用可以直接调用服务器提供的工具来查询数据，无需额外的适配层。
  • 工具化数据访问: 将复杂的API调用抽象为易于理解和使用的工具函数，如“查询企业财务摘要”、“检查化学品安全信息”、“搜索总统演讲稿”等。
  • 环境友好: 提供简单的安装和配置流程，支持流行的包管理工具如 'pip' 和 'uv'。

安装步骤

本仓库包含多个独立的MCP服务器，您可以根据需要选择安装。

  1. 安装 Python 环境: 确保您的系统安装了 Python 3.10 或更高版本。
  2. 安装 'uv' (推荐) 或 'pip':
    • 使用 'uv' (推荐，速度更快): 
      curl -LsSf https://astral.sh/uv/install.sh | sh
    • 使用 'pip': Python 环境通常自带 'pip'。
  3. 安装所需 MCP 服务器: 选择您需要的服务器并运行安装命令。例如，安装“金融委员会企业财务信息”服务器：
    • 使用 'uv': 
      uv pip install data-go-mcp.fsc-financial-info
    • 使用 'pip': 
      pip install data-go-mcp.fsc-financial-info
    其他可用服务器包括：
    • 'data-go-mcp.nps-business-enrollment' (国民年金公团事业场加入内역)
    • 'data-go-mcp.nts-business-verification' (国税厅事业者登録情報真伪确认及状态照会)
    • 'data-go-mcp.pps-narajangteo' (国家采购局)
    • 'data-go-mcp.presidential-speeches' (总统记录馆演说文)
    • 'data-go-mcp.msds-chemical-info' (物质安全保健资料(MSDS) 化学物质信息)

服务器配置

MCP客户端（如 Claude Desktop 或 Cline）需要配置启动 MCP 服务器的命令和参数。请确保在配置前从 data.go.kr 获取相应的 API 密钥，并设置为环境变量 'API_KEY'。

以下是 Claude Desktop 和 Cline 的配置示例，请将 'your-api-key-here' 替换为您的实际 API 密钥。'command' 可以是 'uvx' 或您的 Python 解释器路径（例如 'python'）。

Claude Desktop 配置示例 ('claude_desktop_config.json'):

{
  "mcpServers": {
    "data-go-mcp.nps-business-enrollment": {
      "command": "uvx", // 或您环境中可用的 'python' 命令路径
      "args": ["data-go-mcp.nps-business-enrollment@latest"], // 或 "-m", "data_go_mcp.nps_business_enrollment.server"
      "env": {
        "API_KEY": "your-api-key-here" // 替换为您的实际 API 密钥
      }
    },
    "data-go-mcp.fsc-financial-info": {
      "command": "uvx",
      "args": ["data-go-mcp.fsc-financial-info@latest"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    },
    // ... 其他 MCP 服务器配置
  }
}

Cline (VS Code 扩展) 配置示例 ('.vscode/cline_mcp_settings.json'):

{
  "mcpServers": {
    "data-go-mcp.nts-business-verification": {
      "command": "python", // 或您环境中可用的 'uvx' 命令路径
      "args": ["-m", "data_go_mcp.nts_business_verification.server"],
      "env": {
        "API_KEY": "your-api-key-here" // 替换为您的实际 API 密钥
      }
    },
    // ... 其他 MCP 服务器配置
  }
}

基本使用方法

配置完成后，您的LLM客户端将能够发现并调用这些MCP服务器提供的工具。例如，在Claude Desktop或Cline中，您可以通过自然语言指示LLM使用工具：

  • “查询法人的 2023 年财务报表摘要，法证登记号为 1101111848914。”
  • “帮我搜索一下CAS号是71-43-2的化学品安全信息，尤其是其危险性。”
  • “查找首尔江南区的所有国民年金参保企业。”
  • “检查一下사업자등록번호 123-45-67890 的税务登记状态。”
  • “搜索 2024 年 5 月 15 日的나라장터入札公告。”
  • “列出最近的5篇总统演讲稿。”

信息

分类

AI与计算

访问项目