房地产搜索与市场统计MCP服务器

为法国房地产市场提供的MCP服务器,支持房产搜索、市场指标统计、相似房源推荐以及带Webhook通知的保存搜索。

  • by StreamEstate
  • TypeScript
  • 混合部署
  • 3 星标
  • 更新于
在 GitHub 查看 StreamEstate/mcp-server

使用说明

Stream Estate MCP Server (v1, deprecated)

[!WARNING] This server is deprecated and will stop working on 31 December 2026, together with the Stream Estate API v1. Switch to the v2 remote MCP server: https://api-v2.stream.estate/mcp (HTTP transport, X-API-KEY header), listed in the MCP Registry as estate.stream/mcp. Setup guide: https://next.docs.stream.estate/en/docs/guides/mcp

claude mcp add --transport http streamestate https://api-v2.stream.estate/mcp --header "X-API-KEY: <your_key>"

MCP server for the Stream.estate French real estate API. Search properties, get market statistics, manage saved searches with webhook notifications, and more.

Prerequisites

Quick Start

Claude Code (one command)

claude mcp add -e STREAM_ESTATE_API_KEY=your-api-key stream-estate -- npx mcp-stream-estate

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "stream-estate": {
      "command": "npx",
      "args": ["mcp-stream-estate"],
      "env": {
        "STREAM_ESTATE_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration

Environment Variable Required Default Description
STREAM_ESTATE_API_KEY Yes — Your Stream.estate API key (sign up)
STREAM_ESTATE_BASE_URL No https://api.stream.estate API base URL

Available Tools

Properties

Tool Description
search-properties Search properties with 50+ filters (location, price, size, energy, etc.)
get-property Get full property details by UUID
find-similar-properties Find properties similar to a given one

Indicators

Tool Description
get-cities Search cities by name, zipcode, or INSEE code
location-autocomplete Autocomplete city/department names (returns IDs for filters)
get-points-of-interest Find nearby schools, hospitals, restaurants, etc.
get-price-per-meter Price/m² statistics with average, median, and time series

Saved Searches

Tool Description
create-search Create a saved search with webhook notifications
list-searches List all saved searches
get-search Get a specific saved search
update-search Update saved search criteria
delete-search Delete a saved search

Webhooks

Tool Description
test-webhook Send a test payload to a webhook endpoint

Key Concepts

  • Property types: 0=Flat, 1=House, 2=Building, 3=Parking, 4=Office, 5=Land, 6=Shop
  • Transaction types: 0=Sell, 1=Rent
  • Publisher types: 0=Individual, 1=Professional
  • Energy categories: A (most efficient) through G (least efficient)
  • Use location-autocomplete first to find city/department IDs for search filters

Development

pnpm run dev    # Watch mode
pnpm run build  # Production build
pnpm start      # Run server

License

MIT