Spain AI Kit

🏛️ 西班牙AI套件🇪🇸

西班牙广场，塞维利亚-AI-生成的英雄形象

🇪🇸 AI, meet Spain's open government data

Build AI-powered applications on top of Spanish statistics, legislation, land registry, and meteorological data

   ](https://nodejs.org/)    

\[！注意\] 这是一个由社区驱动的开源项目，不隶属于西班牙政府或任何西班牙官方机构，也不受其认可或与之有联系。所有数据均来自各自机构发布的公共API。

🌍 西班牙的开放数据格局

西班牙拥有欧洲最广泛的公共数据基础设施之一。这 国家公报 它的起源可以追溯到 *马德里公报* --首次发表于 1661 --如今，每一项国家法律、皇家法令和官方公告都以结构化开放数据的形式发布。这 国家统计局 通过公共JSON API公开数千个统计系列。这 卡塔斯特罗 为全国各地的房产提供免费的地籍查询。 西班牙国家气象局 提供超过 8000个城市 西班牙17个自治区和两个自治城市。

问题是：大部分内容都被锁定在XML信封、SOAP端点、仅限西班牙语的文档和特殊的JSON统计格式后面。Spain AI Kit使其可以在一行配置中从AI助手中使用。

• 12,000+ 可通过Markdown查询的西班牙综合法律（国家+所有17个自治区）
• 70+ 国家统计局的统计操作——人口统计、经济、就业、住房、旅游
• 50个省，8000多个市 涵盖地址和地籍查询
• 英国央行每日公报 可按日期、关键字、主题或法律范围搜索
• 天气、紫外线、火灾风险和海滩预报 为了整个国家

📖 什么是西班牙AI工具包？

西班牙AI Kit是 MCP（模型上下文协议）服务器 它将人工智能助手——Claude Desktop、Claude Code、Cursor和其他任何讲MCP的东西——直接连接到西班牙政府的开放数据API。没有刮擦，没有API争论，没有手工翻译西班牙语JSON-stat。

🎯 什么是MCP？

模型上下文协议 是一个开放标准，允许人工智能应用程序通过一致的接口插入外部数据源和工具。每个Spain AI Kit包都是一个独立的MCP服务器，您可以独立安装和挂载——使用一个、全部使用或与其他MCP服务器组合。

受...启发 爱沙尼亚艾工具包 Stefano Amorelli。

📦 包含内容

🗺️ 路线图

🚀 快速开始

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "spain-ine": {
      "command": "npx",
      "args": ["@spain-ai-kit/ine-mcp-server"]
    },
    "spain-boe": {
      "command": "npx",
      "args": ["@spain-ai-kit/boe-mcp-server"]
    },
    "spain-catastro": {
      "command": "npx",
      "args": ["@spain-ai-kit/catastro-mcp-server"]
    },
    "spain-aemet": {
      "command": "npx",
      "args": ["@spain-ai-kit/aemet-mcp-server"],
      "env": {
        "AEMET_API_KEY": "your-api-key-here"
      }
    }
  }
}

克劳德代码

claude mcp add spain-ine -- npx @spain-ai-kit/ine-mcp-server
claude mcp add spain-boe -- npx @spain-ai-kit/boe-mcp-server
claude mcp add spain-catastro -- npx @spain-ai-kit/catastro-mcp-server
claude mcp add spain-aemet --env AEMET_API_KEY=your-key -- npx @spain-ai-kit/aemet-mcp-server

\[！提示\] AEMET API密钥 -天气服务器需要一个免费的API密钥。在30秒内获得一个 开放数据 --只需输入您的电子邮件。其他三台服务器无需设置。

试试看

配置后，询问您的AI助手以下问题：

• 💬 *“西班牙目前的CPI是多少？”*
• 💬 *“搜索西班牙有关数据保护的法律，总结最新变化”*
• 💬 *“显示瓦伦西亚省过去5年的就业统计数据”*
• 💬 *“外国人法对英国国民的居留许可有什么规定？”*
• 💬 *“马德里格兰维亚街1号有什么房产？给我地籍参考”*
• 💬 *“今天安达卢西亚有天气警报吗？”*
• 💬 *“马拉加的紫外线指数是多少，我应该给孩子们涂防晒霜吗？”*
• 💬 *“查找这些坐标100米范围内的房产”*

有关详细的使用示例、提示和故障排除，请参阅 用户指南.

🔧 MCP服务器

INE--国家统计

@spain-ai-kit/ine-mcp-server --连接到 国家统计局 JSON API。70多项统计操作，涵盖人口统计、经济、就业、住房、旅游等领域。

英国央行——立法

Catastro-土地注册处

@spain-ai-kit/catastro-mcp-server --连接到 地籍总局 web服务。西班牙全境的房产查找、地址解析和地理编码。

AEMET--天气

@spain-ai-kit/aemet-mcp-server --连接到 AEMET开放数据 西班牙各地的天气预报、观测和警报。

📚 立法语料库

BOE服务器可选择与 使es合法化，它以Markdown文件的形式提供了12000多项西班牙法律的完整合并文本，并附有Git跟踪的改革历史。

要启用语料库搜索，请使用子模块进行克隆：

git clone --recurse-submodules https://github.com/aplaceforallmystuff/spain-ai-kit.git
# Or if already cloned:
git submodule update --init

新闻报道： 国家立法+所有17个自治区和2个自治市----安达卢西亚、阿拉贡、阿斯图里亚斯、巴利阿里、加那利群岛、坎塔布里亚、卡斯蒂利亚-拉曼恰、卡斯蒂利亚和莱昂、加泰罗尼亚、休达、埃斯特雷马杜拉、加利西亚、拉里奥哈、马德里、梅利利亚、穆尔西亚、纳瓦拉、帕斯瓦斯科、巴伦西亚。

⚡ 技术栈

🛠️ 项目结构

spain-ai-kit/
├── mcp/
│   ├── ine/              # INE Statistics MCP server
│   ├── boe/              # BOE Legislation MCP server
│   ├── catastro/         # Catastro Land Registry MCP server
│   └── aemet/            # AEMET Weather MCP server
├── packages/
│   └── shared/           # Shared utilities (HTTP client, XML parser, validators)
├── corpus/
│   └── legalize-es/      # Git submodule — legislation as Markdown
├── docs/
│   └── GUIDE.md          # User guide with examples and troubleshooting
├── nx.json
└── tsconfig.base.json

🧑‍💻 发展

先决条件

• Git （为立法主体提供子模块支持）

设置

# Clone with submodules
git clone --recurse-submodules https://github.com/aplaceforallmystuff/spain-ai-kit.git
cd spain-ai-kit

# Install all workspace dependencies
npm install

# Build all packages (shared first, then MCP servers)
npm run build

# Run tests
npm test

# Format with Prettier
npm run format

# Watch mode for development
npm run dev

惯例

• npm作用域： @spain-ai-kit/*
• MCP服务器： @spain-ai-kit/{service}-mcp-server
• 共享代码： @spain-ai-kit/shared
• TypeScript严格模式，ES2022目标
• 所有工具处理程序都包裹着 wrapToolHandler （统一错误处理）
• API调用之前验证的所有用户输入（验证器位于 @spain-ai-kit/shared)
• 所有API客户端的速率限制(maxRequestsPerSecond)

🔗 西班牙政府资源

• 🏛️ BOE-官方公报 --官方公报
• 📊 国家统计局 --国家统计研究所
• 🏠 地籍-地籍总局 --土地注册处
• 🌤️ 国家气象局 --国家气象局
• 📂 数据.gob.es --国家开放数据门户
• 🧾 AEAT-税务局 --税务机关
• 💼 国家公共就业服务 --就业服务

🤝 贡献

欢迎PR和问题。看 贡献.md 了解有关添加新MCP服务器和为现有服务器做出贡献的指导方针。

Fork → 分支→ 承诺→ Push → PR

⚖️ 许可证

麻省理工学院——见 许可证 了解详情。

来自公共政府API的立法内容属于公共领域。这 legalize-es 语料库是根据自己的许可证分发的——有关详细信息，请参阅该存储库。

______________________________________________________________________

Copyright © 2026 Jim Christian

Released under the MIT License

jimchristian.net

Made with ❤️ in Valencia for Spain's open data 🇪🇸