Ireland MCP

Ireland MCP

向 ChatGPT、Claude 或 Copilot 咨询爱尔兰相关问题，获取附有官方公共来源引用的答案。

Ireland MCP 是一款免费的 AI 助手连接器。它可以让你的助手查询爱尔兰公共数据，例如人口普查数据、火车时刻、天气预警、房价和 Dáil 事务，并说明每个数字的出处。网站：irishopendata.ie。

• 免费，无需账户或 API 密钥。 只需将一个网址粘贴到你的助手中。
• 只读。 它只查询信息，无法更改或提交任何内容。
• 官方来源。 返回的答案会附上发布机构、许可和数据获取时间，方便你核查。
• 基于 MIT 许可开源。这是一个非官方社区项目，并非政府服务。

我可以问什么？

• “戈尔韦市或科克郡最新的人口概况是什么？”
• “今天都柏林附近有 Met Éireann 天气预警吗？”
• “去年恩尼斯的房屋成交价是多少？”
• “下一班从 Heuston 出发的火车是什么时候？是否有运行中断？”
• “我所在选区目前的 TD 是谁？有哪些法案正在审议？”
• “这个地点附近有哪些受保护栖息地、古迹、规划申请或人口普查区域？”

答案由助手撰写；Ireland MCP 提供数据及其来源。在依赖某个数字之前，请核对日期和来源。

30 秒内完成设置

服务地址为 https://mcp.irishopendata.ie/mcp。无需登录。

• ChatGPT： Plugins → + → Add custom MCP server → 粘贴地址 → No authentication。完整步骤。

• Claude： Settings → Connectors → Add custom connector → 粘贴地址。

• GitHub Copilot CLI：

  copilot mcp add --transport http ireland https://mcp.irishopendata.ie/mcp
  

• VS Code： 添加 .vscode/mcp.json：

  { "servers": { "ireland": { "type": "http", "url": "https://mcp.irishopendata.ie/mcp" } } }
  

检查是否正常工作。 提问："Using the ireland tools, give me the Census 2022 profile of Ennis, Co Clare, and the Met Éireann forecast for Galway. Cite the sources." 答案应链接到 https://data.cso.ie/table/F1015 和 Met Éireann 预报网址。^†

_{† 预报网址使用 http://：Met Éireann 的 https:// 主机目前会重定向到一个 TLS 验证失败的源站。}

Beta 功能

托管服务上默认关闭 Beta 功能。运行自己的副本时可以启用这些功能。

Beta：爱尔兰法律与您的权利（年假和工作时间）

非法律建议。 如需了解您的具体情况，请联系 Citizens Information、Workplace Relations Commission 或律师。

一个可选试点可查找爱尔兰劳动法证据，并附上链接引用。当前仅涵盖两个主题：年假和工作时间。

• 读取内容： Citizens Information 的两个指导页面、《1997 年工作时间组织法》以及列出该法后续变更的《爱尔兰法规汇编》页面。
• 法案文本为 1997 年通过时的版本。 可能未纳入后续修订。请查阅变更页面和引用的来源。
• Citizens Information 目前会阻止自动访问。 其防火墙于 2026 年 10 月 26 日拒绝了试点的请求，因此同步可能只会获取《爱尔兰法规汇编》页面。我们不会将试点伪装成浏览器。要扩大覆盖范围，需要获得许可或 Citizens Information Board 提供的官方导出数据；我们正在申请。
• AI 摘要可能有误。 每个回答都会引用来源。请阅读原文。

如果不使用 Beta，默认的 legislation 来源会引用《爱尔兰法规汇编》中的现行爱尔兰成文法。在此修订版中，这涵盖法案、法定文书和宪法；请查看 ireland_describe，了解特定服务提供的内容。Beta 还加入了 Citizens Information 指导内容以及已存储、带版本信息的证据。

在自己的机器上试用：

npm run legal:sync    # fetch the seed pages into .irish-legal-cache
npm run legal:serve   # chat page and tools at http://127.0.0.1:4173

只要有页面获取失败，legal:sync 就会报错退出。今天 Citizens Information 页面无法获取是预期情况；《爱尔兰法规汇编》页面仍会保存。

或者通过 LEGAL_ENABLED=true 将其添加到主服务（默认关闭）。请先阅读 Beta 评估和试点指南。

---

开发者须知：端点详情

托管端点：https://mcp.irishopendata.ie/mcp 传输方式：Streamable HTTP。身份验证：无。写入操作：无。 注册表：官方 MCP 注册表中的 io.github.c-mongan/ireland-mcp。

## 连接你的助手

客户端	当前设置
Claude 自定义连接器	设置 → 连接器 → 添加自定义连接器 → URL https://mcp.irishopendata.ie/mcp → 无需身份验证。
ChatGPT 插件	在网页版 ChatGPT 中，打开 插件 → + → 添加自定义 MCP 服务。将其命名为 Ireland Open Data，输入 https://mcp.irishopendata.ie/mcp，选择 无需身份验证，查看警告，然后选择 创建为插件。安装后，打开新的 Work 对话并选择 @Ireland Open Data。如果已安装此插件，请直接复用。请参阅 OpenAI 插件快速入门和已测试的连接方式。
VS Code	安装链接（粘贴到浏览器中，或对其运行 open）：vscode:mcp/install?%7B%22name%22%3A%22ireland%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.irishopendata.ie%2Fmcp%22%7D。或者添加 .vscode/mcp.json：{ "servers": { "ireland": { "type": "http", "url": "https://mcp.irishopendata.ie/mcp" } } }。
VS Code Insiders	安装链接：vscode-insiders:mcp/install?%7B%22name%22%3A%22ireland%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.irishopendata.ie%2Fmcp%22%7D。
Cursor	Deeplink：cursor://anysphere.cursor-deeplink/mcp/install?name=ireland&config=...。解码后的配置：{ "type": "http", "url": "https://mcp.irishopendata.ie/mcp" }。
GitHub Copilot CLI	运行 copilot mcp add --transport http ireland https://mcp.irishopendata.ie/mcp，或将下方 JSON 放入 ~/.copilot/mcp-config.json。
Claude Code	claude mcp add --transport http ireland https://mcp.irishopendata.ie/mcp
本地（stdio，无托管端点）	npx -y ireland-mcp。使用 --toolsets=cso,irish-rail 添加指定工具。请参阅自托管。

可移植的 Copilot / MCP JSON：

{
  "mcpServers": {
    "ireland": {
      "type": "http",
      "url": "https://mcp.irishopendata.ie/mcp",
      "tools": ["*"]
    }
  }
}

包含内容

数量	值	定义
数据源	39	上游公共数据源，每个对应一个模块。cross 组合器不属于数据源。
无需操作员密钥即可使用	39 个中的 37 个	NTA 实时数据需要操作员密钥。Logainm 需要 Gaois 操作员账户和 API 密钥。
目录操作	94	90 个数据源操作加 4 个跨数据源操作（list_sources、nearby、ireland_snapshot、ireland_resolve_place），均可通过 ireland_call 调用。
默认工具	9	tools/list 返回的内容：5 个元工具，以及 search、fetch、nearby 和 ireland_resolve_place。
使用 ?toolsets=all 时的工具数	101	每个操作均作为指定类型的工具提供，另加 5 个元工具、search 和 fetch。
提示词	3	area_profile、commute_check、compare_counties。
数据集卡片	39 个中的 39 个	每个数据源都有一张卡片（主题、地理层级、时间覆盖范围、联接键），ireland_catalogue 会据此筛选。请参阅数据集卡片。

上一次针对托管端点上当时目录中的每项操作进行的完整运行：docs/live-all-ops.md（2026-10-26）：82 项中有 78 项通过，1 项失败；3 项需要操作员密钥（NTA、Logainm）。

默认配置涵盖统计数据（CSO、Eurostat、ECB、World Bank）、议会和爱尔兰法令汇编、Met Éireann、交通（Irish Rail、Luas、NTA、TFI 站点、自行车）、房地产、规划、遗产、环境、能源、旅游、游说、薪酬差距报告、地方议会预算等。可选的爱尔兰法律和 Citizens Information 试点默认关闭；请参阅 Beta 功能。

全部 39 个数据源、发布者和许可证

默认配置会在 `src/registry.ts` 中注册 39 个数据源模块。默认的 `nearby`、`ireland_resolve_place`、`search` 和 `fetch` 快捷方式位于这些数据源之上。`ireland_resolve_place` 会将任意地点映射到其郡、议会、LEA、选区、NUTS3 和 ED 代码；请参阅[地点交叉对照表](docs/crosswalk.md)。可选试点数据行需要设置 `LEGAL_ENABLED=true` 并导入语料；请通过 `ireland_catalogue` 查看端点上可用的模块。另请参阅[新增数据源的访问权限和限制](docs/public-source-additions.md)。

对于跨大量数据行的计数、求和、联接和排名，ireland_query 会在服务端加载完整表格（CSO 表格、规划申请、Pobal 评分、交叉对照列表、房产销售、薪酬差距报告、欧盟项目和议会预算），并且只返回答案行，同时提供每项输入的来源信息。planning_search 会返回精确总数，并支持通过 offset 分页；planning_stats 会统计全国的申请数量和拟建住房数量。请参阅服务端查询。

每个数据源都有一张数据集卡片，列出主题、地理层级、时间覆盖范围、更新频率、联接键和许可信息。可以向 ireland_catalogue 查询，例如 {"geo_level": "lea", "topic": "housing"}，仅列出包含相应数据的操作；也可以向 ireland_describe 提供一个数据源，以获取其完整卡片。

领域	来源 ID	发布方 / 来源	操作数	许可
地点/房产	failte-ireland	Fáilte Ireland 住宿和景点	1	CC BY 4.0
交通	tfi-static	TFI NaPTAN 静态站点	1	CC BY 4.0
环境	gsi	GSI 地下水脆弱性	1	CC BY 4.0
地点/房产	logainm	Logainm / Gaois 地名 — 需要运营方密钥	1	CC BY 4.0
统计	ncse	NCSE 学校拨款（操作）	3	Creative Commons Attribution；请查阅数据集条款
统计	cso	中央统计局（CSO）PxStat	4	CC BY 4.0
经济	world-bank	世界银行开放数据	2	CC BY 4.0
统计	eurostat	Eurostat 统计 API	3	Eurostat 重用政策（等同于 CC BY 4.0）
统计	ecb	ECB 数据门户	3	ECB 条款，注明出处后可免费重用
统计	pobal	Pobal HP 2022 年贫困指数	1	CC BY 4.0
统计	data-gov-ie	data.gov.ie	3	依各数据集而定，大多为 CC BY 4.0
经济	cro	公司注册局开放数据	3	CC BY 4.0
经济	kohesio	欧盟委员会 Kohesio — 打包的、带日期的爱尔兰 CSV 导出文件；不是实时数据（刷新指南）	2	符合欧盟重用政策 / CC BY 4.0
统计	smart-dublin	Smart Dublin 开放数据	3	依各数据集而定，大多为 CC BY 4.0
统计	census-areas	CSO 2022 年人口普查小区域 / Tailte Éireann	1	CC BY 4.0
法律/政治	lobbying	SIPO 游说登记册 — 已发布的申报记录（说明）	1	SIPO PSI 重用政策
经济	paygap	PayGap.ie — 附有注释的雇主报告（说明）	1	CC0 1.0
经济	council-budgets	官方地方议会预算工作簿（说明）	2	CC BY-SA 4.0
法律/政治	oireachtas	爱尔兰议会两院开放数据 API — 包含与已颁布法案关联的法案阶段信息	6	Oireachtas 开放数据 PSI 许可
法律/政治	legislation	爱尔兰法令汇编 — 已颁布/制定的法案和法定文书、宪法、修订及生效目录	7	Oireachtas（开放数据）PSI 许可（纳入 CC BY 4.0）
法律/政治	eu-law	欧盟出版局 — Cellar SPARQL — 按 CELEX 或 ELI 查询欧盟法案元数据	1	委员会关于重用的决定 2011/833/EU 声明
法律/政治	irish-legal（可选试点）	爱尔兰法律证据语料库 — 已编入索引的来源版本和法案章节；年假/工时种子数据；现行法律尚未核实	6	各文档遵循发布方许可；修订版法案的存储与再分发须经许可
统计	cib	Citizens Information Board 数据中心 — 已固定版本并通过校验和验证的 2021–2025 年年度 CIS 和 CIPS 统计数据；不是实时数据（说明）	3	CC BY 4.0
法律/政治	civic-directory	Éire Civic Tech Directory，由 CitizenData.ie 提供入口 — 已固定版本的目录；状态和链接按所列内容提供，未经核实（说明）	1	MIT（目录）
法律/政治	citizens-info（可选试点）	Citizens Information Board — 来自有限试点语料库、已编入索引的说明性指南	2	CC BY 4.0；不包括第三方材料
地点/房产	geohive	Tailte Éireann GeoHive 边界数据	4	CC BY 4.0
地点/房产	wikidata	Wikidata	2	CC0 1.0
地点/房产	ppr	住宅房产价格登记册	2	PSI 通用许可 / CC BY 4.0
地点/房产	planning	国家规划申请数据库	2	CC BY 4.0
地点/房产	heritage	国家古迹管理局 SMR	1	CC BY 4.0
环境	met-eireann	Met Éireann	3	CC BY 4.0
环境	marine	海洋研究所气象浮标	1	CC BY 4.0
环境	opw-water	OPW waterlevel.ie	2	CC BY 4.0
环境	environment-sites	NPWS 指定保护区	2	CC BY 4.0
环境	epa	EPA WFD 和沐浴水开放数据（操作）	5	CC BY 4.0
交通	nta	国家交通管理局 GTFS-Realtime	2	CC BY 4.0
交通	irish-rail	Iarnród Éireann 实时 API	2	公共开放数据；须注明出处
交通	luas	Luas 预测 API / TII	2	CC BY 4.0
交通	bikes	CityBikes / GBFS	2	须注明 CityBikes 并提供链接；遵循底层运营方条款
能源	eirgrid	EirGrid 智能电网仪表板	1	公共信息；须注明出处
经济	ted	欧盟 TED	2	符合欧盟重用政策 / CC BY 4.0
公民数据源新增内容和 GeoHive 图层选择说明见 civic source notes。统计数据反映此修订版本中的代码，并非部署凭证。请使用 ireland_catalogue 检查连接的服务；使用 node scripts/live-civic.mjs --url https://mcp.irishopendata.ie/mcp 验证发布版本。

为什么保持精简

大多数数据 MCP 会预先公开所有类型化工具。Ireland MCP 将默认的 tools/list 保持为 9 个工具、14,784 个字符，约 3,696 个令牌（toolsets=all 包含 101 个工具，约 30k 个令牌）（npm run measure:tools）。如果列表超过 16,000 个字符，CI 就会失败。

需要类型化工具？

表面	用途
默认 HTTP	/mcp 仅列出 ireland_catalogue、ireland_describe、ireland_call、ireland_query、ireland_about、search、fetch、nearby、ireland_resolve_place。
数据源工具集	/mcp?toolsets=cso,irish-rail 也会列出所选的类型化工具。
单个数据源路径	/mcp/x/{source} 会列出该数据源的类型化工具，例如 /mcp/x/met-eireann。
所有工具	/mcp?toolsets=all 会列出所有可用工具，适合调试，不适合日常聊天。
本地 stdio	npx -y ireland-mcp --toolsets=cso 或 --toolsets=all。

max_tokens 默认约为 2,000 个输出令牌，可设置为 100 到 8,000。大型结果会返回 truncated、计数和缩小范围的提示，而不是淹没上下文。

使用托管服务或自托管

• 使用托管端点（https://mcp.irishopendata.ie/mcp），除非有特殊原因不使用。它免费、无需密钥，维护者会确保其持续运行。
• 自行运行：使用 npx -y ireland-mcp（stdio）、npm run dev:http（本地 HTTP）或自己的 Azure 部署。详见 docs/self-hosting.md。
• 贡献数据源：如果缺少爱尔兰的公开数据，请添加数据源。详见贡献指南。

隐私和使用次数统计

• 只读，无账户；日志或遥测中不包含参数值或 IP 地址。
• 托管服务会在 PostHog 中保留汇总使用次数统计：记录使用了哪些数据源和客户端应用，但不记录任何身份信息。网站会统计匿名页面浏览量，不使用 Cookie。PRIVACY.md 列出了所有字段。
• 自托管副本不会发送使用次数统计，除非你配置了 PostHog。使用模板部署到 Azure 时，会将跟踪数据和指标导出到你自己的 Application Insights；设置 IRELAND_MCP_OTEL=off 可停止导出。本地 stdio 和 HTTP 不会发送任何数据。
• GET /healthz（添加 ?deep=1 可检查各数据源）和公开的状态动态会报告服务运行状况。

限制

• 仅提供只读公开数据。不提供受登录限制、付费或需要密钥才能访问的用户数据。
• NTA 实时数据和 Logainm 地名需要服务端运营方密钥；其他所有数据源均无需密钥。
• 上游数据可能延迟、暂定、不完整或暂时不可用。过期缓存会标记为 stale: true，且仅在可重试的故障时使用。永久性请求错误、访问错误和资源缺失错误仍会显示。
• 房产价格登记册中的数值为申报的成交价格，并非估价。
• 法律文本用于检索和分析，不构成法律建议。可选法律试点仅涵盖已摄取的页面。已颁布的文本、Citizens Information 指南和任何允许的整合文本都需要核实修正情况、生效日期和来源时效性；它们并不能证明法律当前仍然有效。
• 大型表格会分页或截断。请使用 fields、limit、cursor 和数据源筛选条件。

贡献

添加新的数据源是最有价值的贡献。你可以申请添加，也可以自行添加：

1. 创建 src/sources/<id>/index.ts，导出一个包含 info、summary、domain、coverage、工具以及可选 search() 和 fetchById() 的 SourceModule。包含 search() 的数据源还必须为其返回的 ID 实现 fetchById()。
2. 为每个工具名称添加数据源前缀，使用 zod 验证参数，并返回包含数据源 URL、许可证和归属信息的证据封装。
3. 使用 ctx.cachedJson / ctx.cachedText，以应用上游预算、缓存、熔断器和过期数据回退机制。
4. 在模块边界处添加测试夹具和测试，然后在适用时添加服务端级别的 ireland_call 测试。
5. 在 src/registry.ts 中注册该模块，并更新 scripts/live-sanity.mjs、评估用例和文档。
6. 提交 PR 前，运行 lint、typecheck、tests、build、inspector 和 live sanity。

完整清单请参阅 CONTRIBUTING.md。

开发命令、评估和质量流程见 docs/development.md。

许可与署名

层级	许可 / 署名
代码	MIT，版权归 Conor Mongan 所有。
源元数据和返回的数据	继续遵循各发布方的许可。每个常规工具响应都包含 source、url、licence、attribution、retrieved_at、缓存和截断元数据。
CSO / Eurostat / ECB / Wikidata / World Bank	分别注明 CSO、Eurostat、ECB Data Portal、Wikidata 贡献者和 World Bank Open Data；Wikidata 采用 CC0 许可。
Oireachtas / legislation / PSI sources	按响应中所示，注明 Oireachtas Open Data、eISB / Office of the Attorney General、PSRA、OPW 及其他列出的 PSI 发布方。
CIB Data Hub / civic directory	CIB 统计数据：“包含依据 Creative Commons Attribution 4.0 International（CC BY 4.0）许可的爱尔兰公共部门数据”，并注明 Citizens Information Board。名录：注明 Éire Civic Tech Directory（MIT，William Kennedy）及列出的项目所有者。
Optional legal pilot	保留每份文档的引用和 Citizens Information Board 署名。重用 Law Reform Commission Revised Acts 需获得明确许可；请参阅 source policies。
Weather, transport, environment, business and maps	视情况注明 Met Éireann、NTA、Iarnród Éireann、TII/Luas、EirGrid、Marine Institute、Tailte Éireann、NMS、NPWS、EPA、Pobal、CRO、Kohesio/TED 和 JCDecaux/CityBikes/GBFS。
完整声明	请参阅 NOTICE。本项目与任何政府机构、数据发布方或交通运营商均无关联。

致谢与先例

感谢 Irish-data 和 public-data MCP 项目的维护者，他们帮助我们确定了发展方向：

项目	参考内容
keithd1998/irlcli	供大模型使用的爱尔兰开放数据命令行工具。
sumitsimplex/irish-mcps 和 irishmcp.ie	爱尔兰 MCP 平台和公共数据用户体验。
faulknco/archaic-stats-mcp	专注于爱尔兰统计数据的 CSO/PxStat MCP。
datagouv/datagouv-mcp	国家级开放数据目录 MCP 模式。
brockwebb/open-census-mcp-server	人口普查数据 MCP 接口和解读模式。
ondata/ckan-mcp-server	CKAN 搜索 / 查询服务设计。
cyanheads/eurostat-mcp-server	Eurostat MCP 实现。
isakskogstad/OECD-MCP	OECD 统计数据 MCP。

数据来自上文列出的发布方，包括 CSO、data.gov.ie、Met Éireann、OPW、Irish Rail、Oireachtas、GeoHive/Tailte Éireann、National Monuments Service、NPWS、EPA、Pobal、CRO、World Bank、Eurostat、ECB、Wikidata、Kohesio、TED、JCDecaux/CityBikes 等。请注明每条响应中显示的发布方。

更多

• 证据：已测试的客户端、屏幕截图和演示视频
• 架构和请求流程
• 自托管 · 部署到 Azure · 发布
• 可观测性 · 隐私 · 安全

安全

安全问题报告：SECURITY.md。本项目为只读项目，但 MCP 服务仍可能获取不可信的网页内容；客户端应遵循其常规 MCP 信任和审批模型。