Seoul Data

mcp-seoul-data

Seoul Open Data MCP — 通过 Seoul Open Data Plaza API 获取首尔城市数据

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

工具	描述
seoul_real_estate	来自官方登记机构的首尔房产／公寓售出交易（실거래가）。对于“<首尔行政区>的公寓价格”“首尔近期房产成交”“<建筑>卖了多少钱”等问题，优先使用此工具。可选按年份和行政区代码筛选。返回建筑名称、社区（洞）、成交价（KRW）、建筑面积（m²）、楼层和合同日期。常见行政区代码：
seoul_air_quality	首尔各行政区（자치구）的实时空气质量 — PM10、PM2.5、臭氧、NO2、CO、SO2、综合空气指数（CAI）及其等级（좋음/良好……나쁨/较差）。用于查询“首尔／<行政区>的空气质量”“首尔当前的 PM2.5”。
seoul_events	首尔文化活动 — 展览、音乐会、节庆、演出 — 包含标题、类别、行政区、日期、场馆、目标受众和费用。用于查询“首尔的文化活动”“<首尔行政区>近期有什么活动”。
seoul_dataset	根据服务名称（서비스명），通用转发到任意 Seoul Open Data Plaza 服务 — 返回原始行。用于获取特定工具未涵盖的首尔数据集（例如，地铁客流量“CardSubwayStatsNew”、停车信息“GetParkingInfo”、自行车站点“tbCycleStationInfo”、人口“SPOP_LOCAL_RESD_DONG”）。可在 data.seoul.go.kr 浏览服务。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "seoul-data": {
      "url": "https://gateway.pipeworx.io/seoul-data/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/seoul-data/mcp 上的 tools/list 返回上表中的工具，以及 Pipeworx 通用元工具 — ask_pipeworx、discover_tools、search_within、remember/recall 和网关全局工具集中的其他工具。因此，你看到的工具数量会多于此表所列：目前，单个工具包端点除自身工具外，还会列出大约 30 个通用工具。连接的 initialize 响应会说明其确切范围，是当日有效的权威信息。

这是有意设计的，并非意外复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题 — 通过 ask_pipeworx 跨整个目录进行路由 — 而无需添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的 schema 占用的上下文比路由功能带来的收益更大，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不仅仅是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是哪些工具包的工具会被直接列出；通过任一端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/seoul_real_estate \
  -H 'Content-Type: application/json' \
  -d '{"year":2026,"district_code":"11680","limit":10}'

首次调用无需账号。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/seoul_real_estate。查找工具包：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账号）

此软件包也可以作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账号，也不必经由网关：

{
  "mcpServers": {
    "seoul-data": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-seoul-data"]
    }
  }
}

或者直接运行以确认它可以启动：

npx -y @pipeworx/mcp-seoul-data

它通过 stdin/stdout 使用 MCP，并为仅限此工具包的工具响应 initialize/tools/list/tools/call — 不包含上文网关连接所添加的任何通用元工具。数据源相同，工具相同，不提供 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英文提问，而不是直接调用工具 — 此功能既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Seoul Data data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT