AI导哈

西班牙地籍数据查询服务

一个通过MCP协议查询西班牙地籍数据的服务，允许用户通过自然语言查询获取房产的详细信息。

  • by omarcazorla
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 omarcazorla/Catastro-MCP

使用说明

西班牙MCP灾害服务器

MCP（模型上下文协议）服务器，用于直接从Claude Desktop查询西班牙国家土地总局的地籍数据。

🚀 这是什么

一个MCP服务器，让Claude能够自然地查询西班牙房产的地籍数据。你只需向Claude询问任何房产信息，它就会自动在地籍系统中搜索相关信息。

示例： “查找地籍编号为7952405DF1875B的房产”，克劳德将为你提供所有相关信息：地址、面积、房龄、用途等。

💻 安装

先决条件

  • Python 3.8或更高版本
  • Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体化为某款软件或平台的名称）
  • macOS、Windows 或 Linux

步骤1：克隆仓库

git clone https://github.com/tu-usuario/Catastro-MCP.git
cd Catastro-MCP

步骤2：创建虚拟环境（推荐）

在 macOS/Linux 上：

python3 -m venv venv
source venv/bin/activate

在Windows中：

python -m venv venv
venv\Scripts\activate

步骤3：安装依赖项

pip install -r requirements.txt

或者手动地：

pip install fastmcp httpx

步骤4：配置Claude Desktop

编辑Claude Desktop的配置文件：

macOS（苹果电脑操作系统） ~/Library/Application Support/Claude/claude_desktop_config.json

Windows： %APPDATA%\Claude\claude_desktop_config.json

Linux： ~/.config/Claude/claude_desktop_config.json

添加此配置（将路径调整为您的安装位置）：

{
  "mcpServers": {
    "catastro": {
      "command": "/ruta/completa/al/venv/bin/python",
      "args": ["/ruta/completa/a/catastro_mcp.py"]
    }
  }
}

在 macOS 中的示例：

{
  "mcpServers": {
    "catastro": {
      "command": "/Users/omar/Documents/GitHub/Catastro-MCP/venv/bin/python",
      "args": ["/Users/omar/Documents/GitHub/Catastro-MCP/catastro_mcp.py"]
    }
  }
}

步骤5：重启Claude Desktop

完全关闭 Claude Desktop（在 macOS 上按 Cmd+Q）并重新打开。

💁 如何使用

1. 按地籍编号搜索（最推荐）

Busca el inmueble con referencia catastral 7952405DF1875B

克劳德将自动搜索并返回该房产的所有数据。

2. 按地址搜索

Busca datos del inmueble en CL Mayor 76, Molins de Rei, Barcelona

注： 按地址搜索取决于地籍局如何记录地址。如果未找到结果，最好使用地籍编号。

3. 内部定位搜索

Busca el piso en CL Mayor 10, escalera A, planta 3, puerta B en Segovia

🔍 最佳实践

  1. 在可能的情况下使用地籍参考 - 它们更可靠、更准确
  2. 请指明省和市 - 提高搜索的准确性
  3. 使用官方缩写 针对轨道类型（CL、AV、PS等）

📋 经过验证的真实案例

# Funciona perfecto ✅
Busca el inmueble con referencia catastral 7952405DF1875B

# Devuelve múltiples inmuebles de la misma finca ✅
Busca inmuebles con referencia catastral 9134308DF2893C

# Búsqueda por dirección (puede fallar según el Catastro) ⚠️
Busca el inmueble en CL BALMES 203, Barcelona

最常见的轨道类型

代码 描述
CL 街道
AV 大街
PS 散步
PZ 广场
CM Camino
CR 公路
TR 旅行
UR 城镇化
PJ 通道
GL 小圆环（或环岛）

请参阅官方地籍文件中的完整列表（附件II）。

📦 服务器响应

整套房产

当找到一个单独的房产时，返回：

{
  "tipo_respuesta": "inmueble_completo",
  "inmueble": {
    "referencia_catastral": "2749704YJ0624N0001DI",
    "tipo": "UR",
    "direccion": "CL Alcalá 45",
    "provincia": "Madrid",
    "municipio": "Madrid",
    "uso": "Residencial",
    "superficie_m2": 85.5,
    "coef_participacion": 0.054,
    "antiguedad": 1975,
    "localizacion_interna": {
      "escalera": "A",
      "planta": "3",
      "puerta": "B"
    },
    "unidades_constructivas": [
      {
        "uso": "Vivienda",
        "superficie_m2": 85.5,
        "tipologia": "Piso"
      }
    ]
  }
}

房产列表

当存在多个匹配项时：

{
  "tipo_respuesta": "listado_inmuebles",
  "total": 3,
  "inmuebles": [
    {
      "referencia_catastral": "2749704YJ0624N0001DI",
      "direccion": "CL Alcalá 45",
      "provincia": "Madrid",
      "municipio": "Madrid",
      "localizacion_interna": {
        "escalera": "A",
        "planta": "1",
        "puerta": "A"
      }
    }
  ]
}

候选人相关错误

当未找到参数时，返回建议：

{
  "error": true,
  "codigo": "12",
  "descripcion": "LA PROVINCIA NO EXISTE",
  "candidatos_provincias": [
    {
      "codigo_ine": "28",
      "nombre": "Madrid"
    },
    {
      "codigo_ine": "08",
      "nombre": "Barcelona"
    }
  ]
}

✨ 特点

  • ✅ 搜索按 地籍编号 （更可靠）
  • ✅ 按以下条件搜索 （宗教）教派名称 （省，市，街道，门牌号）
  • ✅ 搜索按 官方代码 (DGC和INE)
  • ✅ 内部定位（楼栋、楼梯、楼层、门）
  • ✅ 房产的完整数据（用途、面积、房龄等）
  • ✅ 详细的构建单元
  • ✅ 分地块（适用于乡村房产）
  • ✅ 智能错误处理，提供建议
  • ✅ 清晰且结构化的JSON格式回复
  • ✅ 正确解析欧洲小数点（逗号）
  • ✅ 完整日志记录用于调试

可用数据

对于城市房产：

  • 地籍编号
  • 完整地址
  • 用途（住宅、商业等）
  • 建筑面积
  • 参与系数
  • 古董；年代感
  • 建筑单元（住宅、商铺、储藏室等）

对于乡村房产：

  • 地籍编号
  • 位置（多边形区域，地块）
  • 种植子地块
  • 表面（或区域、面积）
  • 生产强度

⚠️ 局限性

  • 仅数据 未受保护的 （不包括所有权或地籍价值）
  • 地址搜索取决于地籍管理部门如何记录地址
    • 建议： 尽可能使用地籍参考
  • 需要连接互联网
  • 取决于地籍服务的可用性
  • 地籍服务可能有使用限制

🐛 调试

如果有什么问题，检查日志文件：

tail -f /ruta/a/Catastro-MCP/catastro_mcp.log

此文件包含：

  • 向地籍部门提出的所有请求
  • 完整的XML响应（前1000个字符）
  • 带有堆栈跟踪的详细错误

🔗 有用链接

⚖️ 数据许可与使用

这个项目是根据以下许可发布的： MIT许可证 - 查看文件 许可证 以了解更多详情。

作者： 奥马尔·卡索拉

关于地籍数据的重要信息

此服务器提供的数据来源于 国家地籍总局的公共网络服务 并受其使用条款的约束。本项目仅提供一个MCP接口，以方便访问这些服务。

  • 地籍数据是公开且免费的
  • 此服务器仅访问数据 未受保护的 （无所有权，无地籍价值）
  • 数据的使用必须符合地籍法规
  • 更多信息： 地籍使用条件

注： 这是一个独立项目，与国家土地管理局无正式关联或支持。

相关 MCP