korea-public-data-catalog-mcp

# 韩国公共数据目录 MCP  > 公开远程服务器基准: `v0.4.0-beta.1` · 基本运行时模式: `catalog` 这是一个只读的MCP服务器，可以从韩国公共数据门户的静态列表中，为您想要创建的服务理念找到相关的公共数据候选、提供机构、格式和官方链接，并建议一起审查的候选。 本项目是**元数据路由器**，而不是**数据执行器**。当您提问时，它不会调用公共API或下载文件，也不会提供实际的数据值或实时信息。 ## 一眼看懂的运作方式 ```text 想要创建的服务理念 ↓ 从96,056个静态公共数据列表中搜索相关类型 ↓ 数据名称 · 提供机构 · 格式 · 官方链接和组合顺序建议 ↓ 用户在官方页面确认当前性 · 使用条件 · 实际模式 ``` 上图是为了解释此流程而创建的生成图像。并非实际的政府系统屏幕、官方认证或实时查询结果。图像生成的条件和注意事项在[图像资产指南](docs/IMAGE-ASSET.md)中有详细介绍。 ## 当前目录范围 | 项目 | 当前值 | |---|---:| | 来源 | 公共数据门户 `公共数据门户列表开放现状` | | 来源快照基准日 | 2026-06-30 | | 从CSV中严格解析的唯一列表 | **96,056件** | | 来源详细页面显示的全部行 | **87,581件** | | 两者差异 | **8,475件** | | 查询中的网络/API调用 | 无 | 96,056件是官方CSV中通过严格的CSV解析器验证的唯一行数。[来源详细页面](https://www.data.go.kr/data/15062804/fileData.do)显示为87,581行。本项目不会隐瞒或任意丢弃差异的8,475件，而是公开两个数值。**这两个数字都不声称是韩国全部公共数据的国家总量。** 源和门户的统计标准差异需要在源中重新确认。 96,056个列表类型的代码为`FILE` 83,695件、`API` 12,061件、`STD` 300件。这些不是实际的文件行数或API调用次数，而是目录列表的件数。 每个列表中只包含路由所需的最小字段。 - 列表键和列表类型 - 数据名称，提供机构，分类体系 - 提供格式，更新周期和搜索关键词 - 官方`data.go.kr`网址和来源中显示的使用许可范围文本 不包括源数据行、文件内容、API响应、详细说明、负责人联系方式和认证密钥。 省略环境变量时，将执行`catalog`模式。`beta`模式是用于维护兼容性的旧14件fixture回归测试模式，不是一般用户的默认值。 ## 在Claude中轻松开始 ### 推荐：公开远程自定义连接器 无需安装或Node.js。在Claude登录的浏览器中，打开下面的链接，确认显示的名称和地址后，点击**Add**或**添加**。 [在Claude中添加韩国公共数据目录](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Korea+Public+Data+Catalog&connectorUrl=https%3A%2F%2Fkorea-public-data-catalog-mcp-production.up.railway.app%2Fmcp) 直接输入时，在`Settings/Customize → Connectors → Add custom connector`中使用以下值。屏幕名称根据Claude版本可能会有所不同。 ```text 名称：韩国公共数据目录 远程MCP网址：https://korea-public-data-catalog-mcp-production.up.railway.app/mcp 认证：无 ``` 必须包含`/mcp`。GitHub地址、服务器根地址、`/health`、`localhost`不是连接器网址。如果要在存储库中重新创建预输入链接，请使用以下命令。该命令执行`scripts/print-claude-install-link.mjs`，输出与上述链接相同的地址。 ```powershell npm run claude:install-link -- https://korea-public-data-catalog-mcp-production.up.railway.app/mcp ``` 使用中如果显示HTTP `429`，请在响应中的`Retry-After`时间后重试。共享网络出口的请求可以使用相同的分钟数分组。 连接后，在新聊天窗口的Connectors菜单中启用**Korea Public Data Catalog**，然后执行以下[第一个测试](#连接后第一个测试)。 ### 本地替代方案1：Claude Desktop Release的`.mcpb`安装 这是在不通过公开服务器的情况下，在自己的PC上运行的一种方法。 1. 从[v0.3.0-beta.2发布版](https://github.com/obundh/korea-public-data-catalog-mcp/releases/tag/v0.3.0-beta.2)下载`korea-public-data-catalog-mcp-v0.3.0-beta.2.mcpb`。 2. 双击文件或将其拖放到Claude Desktop中。或者，在`Settings → Extensions → Advanced settings → Install Extension…`中选择。 3. 安装后，在新聊天窗口的`+ → Connectors`中选择**Korea Public Data Catalog**工具。 此文件是Windows和macOS的未签名直接分发测试版，因此可能会出现安装批准警告。可以比较发布的[SHA-256文件](https://github.com/obundh/korea-public-data-catalog-mcp/releases/download/v0.3.0-beta.2/korea-public-data-catalog-mcp-v0.3.0-beta.2.mcpb.sha256)和下载文件的哈希值。 GitHub直接分发的Desktop Extension不会自动更新。发布新版本时，请手动下载新的`.mcpb`并重新安装。如果发布版中尚未附加`.mcpb`，可以使用下面的Claude Code或[手动Desktop设置](docs/CLAUDE-SETUP.md)。 ### 本地替代方案2：在Claude Code中使用存储库的`.mcp.json` 需要Node.js 22.16以上、Git和Claude Code。存储库中已经有项目范围的`.mcp.json`，因此无需输入绝对路径。 ```powershell git clone https://github.com/obundh/korea-public-data-catalog-mcp.git cd korea-public-data-catalog-mcp npm ci npm run build npm test claude ``` 首次打开时，请信任存储库（workspace）并批准使用MCP。在Claude Code中运行`/mcp`以检查是否显示`korea-public-data-catalog`和7个工具。 如果要在所有项目中使用相同的服务器，可以在用户范围内单独注册。以下路径请替换为实际存储库的绝对路径。 ```powershell claude mcp add --transport stdio --scope user korea-public-data-catalog -- node "E:\absolute\path\korea-public-data-catalog-mcp\dist\index.js" claude mcp list claude mcp get korea-public-data-catalog ``` 远程自定义连接器使用上述公开服务器，因此无需安装和本地更新。`.mcpb`、`.mcp.json`和手动JSON设置是在自己的PC上运行的本地方法。两种方法都搜索96,056个静态快照，不调用实时公共API。 有关安装、手动设置和问题解决的详细信息，请参阅[Claude连接指南](docs/CLAUDE-SETUP.md)。 ## 连接后的第一个测试 首先，确认范围。 > 请告诉我目前可用的元数据有多少条。 请区分从CSV解析的数字和来源页面报告的数字，不要声称任何一个是韩国全部公共数据的国家总量。 也不要调用外部API。 如果正常，使用`get_inventory_coverage_status`，应能解释96,056件、87,581件、差异8,475件、基准日2026-06-30、`network_access: false`。 然后，描述您想创建的内容。 > 我想创建一个比较首尔适合养育孩子的社区的服务。 请找出与儿童保育、学校、公园、医院、空气质量、住房相关的公共数据候选，并提供提供机构和官方链接。 请建议一起审查的候选和遗漏的项目，并解释实际值或组合未经过验证。 或者，可以问： > 我想规划一个釜山洪水应对仪表盘。 请找出与洪水历史、降雨量、排水设施、避难所、人口相关的候选，并建议组合顺序。 请注意，不同地区、时间和代码体系可能存在差异，并指出需要从源数据中确认的项目。 响应建议公共数据候选和官方确认路径。不会查询实际行或验证模式键，因此需要区分找不到的需求和不确定性。 ### 答案大致如下 实际句子可能会根据Claude的组织方式有所不同，但正常响应应包含以下结构。 ```text 推荐状态：参考元数据候选 - 儿童保育：候选数据名称 / 提供机构 / 格式 / data.go.kr官方链接 - 学校：候选数据名称 / 提供机构 / 格式 / data.go.kr官方链接 - 公园：候选数据名称 / 提供机构 / 格式 / data.go.kr官方链接 - 医院、空气质量、房价：相同方式的候选和遗漏项目 组合前确认： - 实际地址、行政区代码和基准时间 - 当前提供状态和认证方式 - 使用条件、第三方权利和个人信息 - 实际字段和组合键 注意：未查询实际值和实时API，不保证组合成功 ``` 电动汽车充电站、釜山洪水、创业商圈、最新值请求、法律保证等8个示例整理成[复制粘贴的提示和响应示例](docs/PROMPT-EXAMPLES.md)。 ## 公开工具7个 | 工具 | 工作内容 | |---|---| | `get_inventory_coverage_status` | 快照基准日、两个件数和差异、目录范围确认 | | `list_public_data_sources` | 包含的来源和更新基准确认 | | `search_public_datasets` | 按主题、地区、机构、格式搜索候选 | | `get_public_dataset_details` | 候选的最小元数据和官方URL确认 | | `recommend_data_combination` | 目标合适的候选组合和未满足需求建议 | | `design_public_data_product` | 基于候选的产品构成和验证顺序设计 | | `check_combination_feasibility` | 选择的候选在元数据上的组合可能性检查 | 没有`call_api`等执行工具。 ## 更新方式 每次提问都不会抓取门户。 由于搜索存储库中包含的月度静态快照，因此速度和结果再现性高，也不需要API密钥。 但是，如果门户注册了新的数据或内容发生变化，则不会自动反映。 远程自定义连接器用户无需每次查询时更新或重新安装。项目管理员验证新的快照并部署到服务器后，从那时起的请求将应用新的快照。 Desktop Extension用户需要手动重新安装新的`.mcpb`，源码用户需要更新存储库、重新构建并重启Claude。无论哪种方式，在使用实际源数据之前，请在响应中确认官方URL的发布状态、最新性、使用条件和下载/API方法。 ## 参考结果和法律边界 - 项目代码的MIT License不会代替链接的公共数据或提供机构文档的使用权。 - 元数据的使用许可范围文本是从来源中获取的导航信息，而不是法律意见、使用批准或无风险保证。 - 推荐不保证特定数据的准确性、完整性、最新性、目的适应性或实际组合成功。 - 不代表政府、公共数据门户或提供机构的官方服务、推荐、认证或合作。 - 在获取、加工、组合、商业利用或重新分发实际文件/API之前，请直接确认官方页面的当前条件、第三方权利和个人信息。 - 请勿仅凭此路由结果自动进行灾难、医疗、福利等重要决策。 详细原则请参考[法律安全性设计](LEGAL-SAFETY.md)、[个人信息指南](PRIVACY.md)和[注意事项](NOTICE.md)。这些文件不是法律咨询。 ## 开发确认 ```powershell npm run check npm test npm run inventory:check npm run inventory:test:legal-compliance npm pack --dry-run --json --ignore-scripts ``` 在本地通过MCP协议和工具列表进行可视化确认，请执行： ```powershell npm run inspect ``` 自动测试验证MCP协议和工具响应。由于Claude应用程序的安装和登录状态因用户环境而异，请使用上述确认命令和测试提示进行实际连接确认。 ### Desktop Extension维护 发布管理员使用经过验证的专用staging程序创建`.mcpb`和SHA-256文件。 ```powershell npm run desktop:pack ``` 使用`desktop-extension/manifest.json`作为模板，结果将生成在`artifacts/`中。 请勿在存储库根目录上运行`mcpb pack`或压缩整个存储库为扩展程序包。专用脚本仅限公开的运行时、静态目录、必要文档和生产依赖项，不会将内部库存、原始数据、测试或开发文件混入包中。 ## 文档和举报 - [新手指南](docs/BEGINNER-GUIDE.md) - [Claude连接指南](docs/CLAUDE-SETUP.md) - [远程部署和运维指南](docs/REMOTE-DEPLOYMENT.md) - [复制粘贴的提示和响应示例](docs/PROMPT-EXAMPLES.md) - [生成图像资产指南](docs/IMAGE-ASSET.md) - [法律安全性设计](LEGAL-SAFETY.md) - [个人信息指南](PRIVACY.md) - [更正和屏蔽请求](TAKEDOWN.md) - [安全和敏感信息举报](SECURITY.md) - [注意事项](NOTICE.md) 一般错误和公开元数据修正可以通过GitHub Issues提出。 请勿在公开问题中编写机密值、个人信息或安全漏洞，而是使用GitHub私有漏洞举报。