Fixatia
为开发者

MCP 服务器集成

使用模型上下文协议将 Claude 和其他 AI 助手连接到 Fixatia 的房地产数据库

什么是 MCP？

模型上下文协议（MCP）是一种开放标准，允许 AI 助手如 Claude 安全访问外部数据源。Fixatia 的 MCP 服务器提供对我们欧洲房地产拍卖数据库的实时访问，使 AI 助手能够搜索物业、检索详细信息并发现可用的过滤器。

通过高级过滤器搜索 6 个欧洲国家的数千个拍卖物业

获取全面的物业细节，包括翻新估算、投资回报率计算和多语言描述

动态发现可用的过滤选项，以构建强大的搜索查询

了解更多关于 MCP 的信息

快速开始

1服务器 URL

Fixatia MCP 服务器可在以下地址访问：

https://mcp.fixatia.com/api/mcp

2配置 Claude Desktop

将以下内容添加到您的 Claude Desktop 配置文件中：

Windows： %APPDATA%\Claude\claude_desktop_config.json

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fixatia": {
      "url": "https://mcp.fixatia.com/api/mcp"
    }
  }
}

3开始使用

重启 Claude Desktop 并开始询问有关物业的信息。Claude 将自动使用 Fixatia 工具来搜索和检索物业信息。

尝试询问："在葡萄牙寻找价格低于 €150,000 且投资回报率潜力至少为 20% 的物业"

可用工具

Fixatia MCP 服务器提供三种强大的工具，用于与我们的物业数据库进行交互：

搜索房产

搜索欧洲的房地产拍卖物业。按国家、城市、价格、物业类型、投资回报率潜力等进行筛选。返回匹配物业的列表，包含拍卖价格、市场价值和投资指标等关键信息。

参数

ParameterTypeRequiredDescription
querystring可选按物业标题、城市或地区进行文本搜索
countrystring可选国家代码：es（西班牙）、pt（葡萄牙）、it（意大利）、fr（法国）、de（德国）、hr（克罗地亚）
regionstring可选国家内的地区名称
citystring可选城市名称
propertyTypestring可选物业类型：公寓、房屋、别墅、土地或商业
minPricenumber可选最低拍卖价格（欧元）
maxPricenumber可选最高拍卖价格（欧元）
minRoinumber可选最低投资回报率百分比（例如，20表示20%）
bedroomsnumber可选最低卧室数量
maxResultsnumber可选返回的最大结果数量（默认：10，最大：50）
sortBystring可选排序方式：最新、价格低、价格高、投资回报率高或拍卖即将开始
localestring可选标题/描述的语言（默认：en）。支持18种语言。

示例请求

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_properties",
    "arguments": {
      "country": "pt",
      "maxPrice": 150000,
      "minRoi": 20,
      "maxResults": 5
    }
  },
  "id": 1
}

示例响应

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": {
        "totalCount": 12,
        "results": [
          {
            "id": "b45dc4fc14134da69e9f800f8",
            "title": "2-Bedroom Apartment · Lisbon",
            "country": "pt",
            "city": "Lisboa",
            "propertyType": "APARTMENT",
            "auctionPrice": 120000,
            "marketValue": 165000,
            "potentialRoi": 26.5,
            "bedrooms": 2,
            "squareMeters": 75
          }
        ]
      }
    }]
  }
}

获取物业

通过物业ID获取特定物业的完整详细信息。返回包括多语言描述、图片、位置坐标、翻新估算、拍卖详情和投资指标等综合信息。

参数

ParameterTypeRequiredDescription
idstring必需物业ID（从搜索结果中获得）
localestring可选标题/描述的语言（默认：en）。支持18种语言。

示例请求

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_property",
    "arguments": {
      "id": "b45dc4fc14134da69e9f800f8",
      "locale": "en"
    }
  },
  "id": 2
}

获取筛选选项

获取可用的筛选选项，包括国家、地区、城市、物业类型和价格/投资回报率范围的列表。对于了解可用的搜索参数和构建动态筛选界面非常有用。

此工具不需要参数。

示例请求

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_filter_options",
    "arguments": {}
  },
  "id": 3
}

示例响应

{
  "countries": [
    { "code": "pt", "name": "Portugal", "propertyCount": 45 },
    { "code": "es", "name": "Spain", "propertyCount": 120 },
    { "code": "it", "name": "Italy", "propertyCount": 89 }
  ],
  "propertyTypes": [
    { "type": "APARTMENT", "count": 156 },
    { "type": "HOUSE", "count": 78 }
  ],
  "priceRange": { "min": 5000, "max": 800000 },
  "roiRange": { "min": -5, "max": 45 }
}

send_property_inquiry

OAuth 2.1

发送关于房产的咨询以表达兴趣。此工具需要带PKCE的OAuth 2.1认证。

需要认证（OAuth 2.1）

此工具使用带PKCE的OAuth 2.1进行安全认证。流程是：

  • 用户点击'授权'并通过浏览器登录
  • 授权码被交换为访问令牌（PKCE保护）
  • mcp.tools.sendPropertyInquiry.oauthStep3

参数

ParameterTypeRequiredDescription
propertyIdstring必需要咨询的房产ID
messagestring必需您的咨询消息，至少10个字符

示例请求

// Requires Bearer token authentication
// curl -X POST https://mcp.fixatia.com/api/mcp \
//   -H "Authorization: Bearer YOUR_TOKEN" \
//   -H "Content-Type: application/json" \
//   -d '...'

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_property_inquiry",
    "arguments": {
      "propertyId": "b45dc4fc14134da69e9f800f8",
      "message": "I'm interested in this property. Is it still available?"
    }
  },
  "id": 4
}

示例响应

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{
      "type": "text",
      "text": "Inquiry sent successfully! The property owner will be notified and may contact you."
    }]
  }
}

HTTP API 参考

MCP服务器还提供直接的HTTP API以便程序化访问。所有请求使用JSON-RPC 2.0协议。

端点

GET
/api/mcp

健康检查和服务器信息。返回服务器名称、版本、协议版本和可用工具。

POST
/api/mcp

用于工具执行的 JSON-RPC 2.0 请求。支持初始化、工具/列表、工具/调用和 ping 方法。

支持的方法

  • initialize - 初始化 MCP 会话并获取服务器能力
  • tools/list - 列出所有可用工具及其架构
  • tools/call - 使用参数执行特定工具
  • ping - 健康检查 ping

cURL 示例

curl -X POST https://mcp.fixatia.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_properties",
      "arguments": {
        "country": "pt",
        "maxPrice": 150000
      }
    },
    "id": 1
  }'

试一试

直接从浏览器测试 MCP 服务器。选择工具并配置参数。

选择工具

错误处理

服务器返回标准的 JSON-RPC 2.0 错误响应。以下是常见的错误代码：

CodeMessageDescription
-32600请求无效发送的 JSON 不是有效的请求对象
-32601找不到方法请求的方法不存在或不可用
-32602参数无效无效的方法参数 - 检查必填字段和类型
-32603内部错误内部 JSON-RPC 错误或服务器端问题

示例错误响应

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: Property ID is required"
  }
}

支持的语言

物业标题和描述提供 18 种语言版本。使用 locale 参数获取您首选语言的内容：

英语 (en), 德语 (de), 法语 (fr), 西班牙语 (es), 意大利语 (it), 葡萄牙语 (pt), 荷兰语 (nl), 波兰语 (pl), 希腊语 (el), 罗马尼亚语 (ro), 捷克语 (cs), 匈牙利语 (hu), 中文 (zh), 阿拉伯语 (ar), 俄语 (ru), 日语 (ja), 韩语 (ko), 克罗地亚语 (hr)

机器可读文档

为 AI 助手和自动化工具，我们按照 llms.txt 标准提供纯文本文档文件：

llms.txt

简洁文档，包含服务器 URL、配置和工具摘要

llms-full.txt

完整文档，包含所有参数、请求/响应示例和错误代码

在以下网站了解更多关于 llms.txt 标准的信息 llmstxt.org

需要帮助吗？

如果您对与 Fixatia MCP 服务器的集成有任何疑问或遇到任何问题，我们的开发支持团队随时为您提供帮助。

联系开发支持在 GitHub 上报告问题