opendata-cat

Opendata.cat MCP 服务

MCP（Model Context Protocol）服务，可将大语言模型（Claude、ChatGPT、Gemini……）与加泰罗尼亚公共开放数据连接起来。直接从你的 AI 助手中搜索数据集、探索元数据并查询 15 个门户的真实数据。

这是 opendata.cat 的一个项目——该非营利协会成立于 2012 年，致力于推动加泰罗尼亚开放数据的透明度、传播和标准化。项目灵感来自法国政府的 datagouv-mcp。

可用门户

加泰罗尼亚门户

门户	数据集	API
加泰罗尼亚自治区政府	1.059	Socrata (SoQL)
Consorci AOC	~887	CKAN datastore
巴塞罗那市政府	555	CKAN datastore
Idescat	138	Idescat API
雷乌斯市政府	119	CKAN datastore
巴塞罗那省议会	90	REST + JSON:API (CIDO)
赫罗纳市政府	53	CKAN datastore
FGC（铁路）	50	Opendatasoft + GTFS-RT
Renfe Rodalies	6	CKAN + GTFS-RT JSON

国家数据源（聚焦加泰罗尼亚）

数据源	数据集	提供内容
INE	6	人口、IPC、EPA（失业／就业）、旅游、GDP、住房——自动筛选加泰罗尼亚数据
Red Electrica (REE)	4	发电量（能源结构）、需求、平衡、实时 PVPC 价格
SEPE	2	加泰罗尼亚各市镇的登记失业人数和合同
CNMC / Ministeri	1	加泰罗尼亚约 1,500 家加油站的燃油价格，可按市镇筛选

来自 15 个门户的**+3,073 个数据集**。大多数支持使用筛选器、搜索和分页进行查询。

目录每周自动更新。使用 --portal 增量抓取新数据源，无需重新扫描全部内容。

访问类型：

• Socrata：使用筛选器和搜索进行 SoQL 查询（Generalitat）
• CKAN：使用筛选器和搜索进行 datastore_search（Barcelona、AOC、Reus、Girona、Renfe）
• Diba REST：do.diba.cat API，支持分页和筛选（Diputacio BCN）
• CIDO JSON:API：api.diba.cat，用于采购、法规和补贴（Diputacio BCN）
• Opendatasoft：records API，支持筛选和搜索（FGC）
• GTFS-RT：实时获取 FGC 和 Renfe Rodalies 列车的 GPS 位置、警报和延误
• Idescat：包含时间序列的统计指标
• INE：自动筛选为加泰罗尼亚数据的西班牙官方统计数据
• REE：实时获取发电量、需求和电价（PVPC）
• CNMC：按服务站提供燃油价格，可按自治区／省／市镇筛选
• GIS：自动简化几何图形（质心 + bbox）
• Dades municipals AOC：9 个数据集，包含 +1,000 个市镇的数据，可按 NOM_ENS 筛选

快速安装

Claude Desktop

将以下内容添加到配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "opendata-cat": {
      "command": "npx",
      "args": ["-y", "@opendata.cat/mcp-server"]
    }
  }
}

Claude Code (CLI)

claude mcp add opendata-cat -- npx -y @opendata.cat/mcp-server

VS Code / Cursor

将以下内容添加到项目的 .vscode/mcp.json 文件：

{
  "servers": {
    "opendata-cat": {
      "command": "npx",
      "args": ["-y", "@opendata.cat/mcp-server"]
    }
  }
}

Windsurf / Cline / JetBrains / Gemini CLI / Warp / ChatGPT / Copilot Studio

查看完整指南，了解 13 个 MCP 客户端的配置说明：opendata.cat/mcp。

你也可以直接通过 Streamable HTTP 连接，无需安装任何内容：

https://opendata.cat/api/mcp

可用工具

工具	描述
search_datasets	在包含 +3,073 个数据集的目录中进行全文搜索
get_dataset_info	返回完整元数据：字段、类型、许可证、端点
list_dataset_fields	列出数据集的字段，包括名称、类型和描述
query_dataset	直接从源门户查询实际数据
list_portals	列出 15 个可用门户及统计信息
list_categories	列出可用类别和主题及其计数
related_datasets	返回其他门户中的相关数据集
search_radioteca	搜索 radioteca.cat 目录（约 485K 个剧集、节目及人员，涵盖 Catalunya Radio、RAC1、Catalunya Musica、iCat、RTVE 等）。始终返回 radioteca.cat 的绝对 URL，以便追溯

search_datasets

通过全文搜索查找数据集。

query: "qualitat aire"
portal: "barcelona"        # opcional: generalitat, barcelona, diba, aoc, reus, girona, fgc, idescat, renfe, ine, ree, sepe, cnmc
category: "Medi Ambient"   # opcional
limit: 20                  # opcional (defecte: 20)

query_dataset

直接向源门户执行查询并返回实际数据。

dataset_id: "generalitat:gn9e-3qhr"
filters: {"estaci": "Sau"}   # opcional
search: "embassament"         # opcional
limit: 20                     # opcional (defecte: 20, max: 100)
offset: 0                     # opcional

国家数据源筛选器示例：

• INE：自动筛选加泰罗尼亚数据（人口、IPC、旅游……）
• REE：ree:preus-electricitat — 按小时提供 PVPC 价格
• CNMC：filters: {"municipi": "Sabadell"} — Sabadell 的加油站

技能

除了工具和提示词，服务器还发布技能：研究指南 （SKILL.md 风格），引导大模型逐步完成特定领域的工作——例如如何选择数据集、 筛选、分页和正确引用。它们随软件包一起分发（skills/），并作为 MCP 资源 （skill://<nom>/SKILL.md，通过 resources/list + resources/read）提供，也作为 可通过斜杠命令调用的桥接提示词（/mcp__opendata_cat__skill_<nom>）提供。

技能	用途
consulta-dades-obertes	通用指南：浏览 15 个门户、直接查询与搜索、分页、引用
contractacio-publica	调查公共采购：交叉查询 PSCP、市政登记和授标信息，汇总金额
radar-municipal	交叉查询各门户，全面描绘一个市镇（预算、债务、合同、人口）
patrimoni-i-hemeroteca	在 Catalònica（BNC）和 radioteca.cat 上开展研究，选择子门户并提供必要引用

这些技能也通过 HTTP 端点 https://opendata.cat/api/mcp 提供。

使用示例

配置完成后，你可以向大模型提问，例如：

• “加泰罗尼亚水库的状况如何？”
• “Rodalies 或 FGC 现在有晚点的列车吗？”
• “根据 INE，加泰罗尼亚的人口是多少？”
• “萨瓦德尔今天的汽油价格是多少？”
• “现在的电价是多少？（PVPC）”
• “分析特拉萨的空气质量。”
• “加泰罗尼亚的失业率是多少？”
• “巴塞罗那有多少旅游过夜住宿？”
• “比较赫罗纳和塔拉戈纳的开放数据。”
• “给我 Reus 最新的预算数据。”
• “Tiana 的负债情况如何？”

工作原理

Usuari → LLM → MCP opendata.cat → API opendata.cat (cataleg)
                                 → Portal origen (dades reals)

1. MCP 查询 opendata.cat 的 API，以发现相关数据集
2. 用户需要具体数据时，MCP 会直接向源门户发起查询
3. 数据返回给大模型，由大模型解读并呈现给用户

它不存储数据，也不代理数据。每次查询都会直接发送到官方来源。

REST API

除了 MCP 服务，opendata.cat 还提供公共 REST API：

端点	描述
GET /api/all-datasets.php	完整列表，支持分页、筛选和排序
GET /api/datasets.php?q=...	按自由文本搜索数据集
GET /api/dataset.php?id=...	数据集完整详情
GET /api/categories.php	类别和门户及其计数
POST /api/mcp	MCP 服务（Streamable HTTP）

交互式文档（Swagger）：opendata.cat/api/docs.html

关于 opendata.cat

opendata.cat 是一家加泰罗尼亚非营利协会，成立于 2012 年（注册号 47468），致力于促进透明度和获取公共信息。

更新日志

v0.6.0 (2026-07-15)

• 新增作为 MCP 资源（skill://<nom>/SKILL.md）提供的技能 + 桥接提示词（skill_<nom>）
• 4 项研究技能：consulta-dades-obertes、contractacio-publica、radar-municipal、patrimoni-i-hemeroteca
• 随 skills/ 一起打包，并与 HTTP 端点 opendata.cat/api/mcp 同步

v0.5.0 (2026-06-06)

• 新增工具 search_radioteca：在 radioteca.cat 上搜索（约 485K 份加泰罗尼亚广播文档——8 家电台）
• 筛选器 publisher、year、type（Episode/Program/Person）
• 所有命中结果都包含 radioteca.cat 的绝对 URL，便于追溯
• 在 opendata.cat 上进行服务端代理——Typesense 密钥不会暴露在 npm 软件包中

v0.3.1 (2026-04-17)

• 将 CNMC 燃油价格处理程序加入 npm 软件包（此前只能通过 HTTP 使用）
• 按市镇和省筛选：filters: {"municipi": "Sabadell"}
• 默认返回整个加泰罗尼亚的数据（约 1,500 个加油站）
• 新增包含 13 个门户和国家级来源的 og:image

v0.3.0 (2026-04-16)

• 新增 5 个西班牙国家级数据源，重点覆盖加泰罗尼亚：INE、REE、SEPE、CNMC
• INE 处理器：官方统计（人口、IPC、EPA、旅游、GDP、住房），自动筛选加泰罗尼亚数据
• REE 处理器：实时电力生产、需求、平衡和 PVPC 价格
• CNMC 处理器：通过 REST API 按自治区／省／市镇筛选燃油价格
• 增量爬虫：使用 --portal 标记加载新数据源，无需重新扫描全部数据
• 13 个门户，2.857 个数据集

v0.2.0 (2026-04-15)

• 新增 Renfe 门户（Rodalies de Catalunya）——6 个数据集（车站、乘客、实时 GTFS-RT）
• 新增 GTFS-RT JSON 处理器，自动筛选巴塞罗那 Rodalies 路线（R1-R16、RT、RG、RL）
• 重写英文说明，以提升 LLM 的理解能力
• 在说明中列出门户、关键词和类别
• 将工具描述和提示词翻译成英文
• 新增提示词 trens_rodalies_temps_real

v0.1.2 (2026-04-14)

• 集成说明：LLM 可获取精选数据集，无需搜索即可直接查询
• 修复 Idescat：现在返回指定指标，而非随机返回 6 项
• 新增 9 个 AOC 市镇数据集：预算、服务成本、1,000 多个市镇的债务

v0.1.0 (2026-04-14)

• 新增 Idescat 门户——138 个统计指标及时间序列
• 新增 Reus 和 Girona 门户

v0.0.17 (2026-04-14)

• 集成 GTFS-RT 解码器：实时 FGC 列车数据
• 使用 Swagger UI（OpenAPI 3.1）编写 REST API 文档

v0.0.10 (2026-04-13)

• FGC 门户（通过 Opendatasoft 提供 50 个数据集）
• 14 个预定义提示词

v0.0.1 (2026-04-12)

• 初始版本：Generalitat、Barcelona、Diba、AOC——6 个工具，npm

许可证

MIT