Repliers MCP-Server

Der Repliers MCP-Server bietet eine Reihe von Tools für den Zugriff auf die Repliers-API in einem mit dem Model Context Provider (MCP) kompatiblen Format.

Die Repliers-API bietet Entwicklern Echtzeitzugriff auf MLS-Angebote, erweiterte Immobiliensuche und Filter, Medienbereitstellung (Bilder, Grundrisse, Touren), Marktanalysen und KI-gestützte Tools wie Sofortbewertungen und Benachrichtigungen. Dies ermöglicht die schnelle Entwicklung von Immobilienplattformen, ohne dass eine Backend-Infrastruktur oder MLS-Integrationen verwaltet werden müssen.

Dadurch können Sie Claude Desktop oder einen beliebigen MCP-Client verwenden, um mithilfe natürlicher Sprache Aufgaben über Repliers-API-Tools zu erledigen, wie zum Beispiel:

"Finde mir 3-Zimmer-Wohnungen in San Francisco unter 1 Million Dollar, die seit weniger als einer Woche auf dem Markt sind"
"Welche Immobilientypen und -stile sind in San Francisco verfügbar?"
"Gib mir die Historie von 123 Main St, San Francisco"
"Was ist der mittlere Listenpreis für zum Verkauf stehende Wohnimmobilien in San Francisco, aggregiert nach Monat innerhalb der letzten 20 Monate?"

Funktionen

Die folgenden Tools für den Zugriff auf die Repliers-API werden vom MCP-Server bereitgestellt.

search - Das Such-Tool ist die Kern-Abfrage-Engine, mit der Sie aktive, verkaufte oder vermietete Immobilienangebote mithilfe flexibler Filter durchsuchen können, wie zum Beispiel:

Standort (Stadt, Nachbarschaft, Koordinaten usw.)
Preisspanne
Immobilientyp & -stil
Schlafzimmer, Badezimmer, Größe
Status (aktiv, verkauft, vermietet)
Schlüsselwörter, Merkmale (z. B. Pool, ausgebauter Keller)
Angebotsdatum, Kennzeichnungen für offene Besichtigungen
und viele mehr

get-a-listing - Ruft detaillierte Informationen für ein bestimmtes Immobilienangebot mithilfe seiner ID oder MLS-Nummer ab, einschließlich der Adresshistorie.

find-similar-listings - Gibt Angebote zurück, die einem bestimmten Objekt basierend auf Standort, Preis, Typ oder anderen Attributen ähnlich sind.

get-address-history - Ruft die historische Angebotsaktivität für eine bestimmte Adresse ab, einschließlich früherer Verkäufe, Vermietungen und Angebotsänderungen.

property-types-styles - Gibt eine Referenzliste der unterstützten Immobilientypen (z. B. Eigentumswohnung, freistehend) und architektonischen Stile für ein bestimmtes MLS-Board zurück.

get-deleted-listings - Bietet Zugriff auf Angebote, die kürzlich aus dem MLS entfernt oder gelöscht wurden.

areas-cities-and-neighborhoods - Gibt einen hierarchischen Katalog geografischer Gebiete, Städte und Nachbarschaften zurück, wie vom MLS bereitgestellt.

buildings - Ruft Daten über bekannte Gebäude (z. B. Eigentumswohnungen oder Apartments) ab, einschließlich Name, Adresse und Metadaten.

Legen wir los!

🚦 Erste Schritte

⚙️ Voraussetzungen

Bevor Sie beginnen, stellen Sie bitte sicher, dass Sie Folgendes haben:

Node.js (v18+ erforderlich, v22+ empfohlen)
npm (in Node enthalten)

Warnung: Wenn Sie eine niedrigere Node-Version verwenden, funktionieren einige Dinge möglicherweise nicht wie erwartet.

📥 Installation & Einrichtung

1. Abhängigkeiten installieren

Führen Sie dies im Stammverzeichnis Ihres Projekts aus:

npm install

🔐 Umgebungsvariablen für Tools festlegen

Sie sollten eine .env-Datei im Stammverzeichnis Ihres Projekts erstellen. Diese Datei enthält die Umgebungsvariable, die die Repliers-Tools zur Authentifizierung bei den APIs verwenden.

Setzen Sie den Wert von REPLIERS_API_KEY auf Ihren Repliers-API-Schlüssel, den Sie in Ihren Repliers-API-Schlüsseln finden. Wenn Sie kein Konto haben, können Sie eines bei Repliers erstellen.

REPLIERS_API_KEY=

Diese Umgebungsvariable wird innerhalb der Tools verwendet, um den API-Schlüssel für jede Anfrage festzulegen. Sie können eine Datei im Verzeichnis tools untersuchen, um zu sehen, wie es funktioniert.

// environment variables are used inside of each tool file
const apiKey = process.env.REPLIERS_API_KEY;

🌐 Testen des MCP-Servers mit Postman

Der MCP-Server (mcpServer.js) stellt Ihre automatisierten API-Tools für MCP-kompatible Clients wie Claude Desktop oder die Postman Desktop Application bereit. Wir empfehlen, den Server zuerst mit Postman zu testen und dann zur Verwendung mit einem LLM überzugehen.

Die Postman Desktop Application ist der einfachste Weg, MCP-Server auszuführen und zu testen. Das Testen des heruntergeladenen Servers ist optional, aber empfohlen.

Schritt 1: Laden Sie die neueste Postman Desktop Application von https://www.postman.com/downloads/ herunter.

Schritt 2: Lesen Sie den Dokumentationsartikel hier, um zu erfahren, wie Sie eine MCP-Anfrage innerhalb der Postman-App erstellen.

Schritt 3: Setzen Sie den Typ der MCP-Anfrage auf STDIO und den Befehl auf node </absoluter/pfad/zu/mcpServer.js>. Wenn Sie Probleme bei der Verwendung von nur node haben (z. B. weil eine alte Version verwendet wird), geben Sie stattdessen einen absoluten Pfad zu einer Node-Version 20+ an. Sie können den vollständigen Pfad zu Node abrufen, indem Sie Folgendes ausführen:

which node

Um die Node-Version zu überprüfen, führen Sie Folgendes aus:

node --version

Um den absoluten Pfad zu mcpServer.js zu erhalten, führen Sie Folgendes aus:

realpath mcpServer.js

Verwenden Sie den Node-Befehl gefolgt vom vollständigen Pfad zu mcpServer.js als Befehl für Ihre neue Postman MCP-Anfrage. Klicken Sie dann auf die Schaltfläche Connect. Sie sollten eine Liste der Tools sehen, die Sie vor der Generierung des Servers ausgewählt haben. Sie können hier testen, ob jedes Tool funktioniert, bevor Sie den MCP-Server mit einem LLM verbinden.

👩💻 Verbinden des MCP-Servers mit Claude

Sie können Ihren MCP-Server mit jedem MCP-Client verbinden. Hier finden Sie Anweisungen zum Verbinden mit Claude Desktop.

Schritt 1: Notieren Sie sich den vollständigen Pfad zu Node und mcpServer.js aus dem vorherigen Schritt.

Schritt 2. Öffnen Sie Claude Desktop → Settings → Developers → Edit Config und fügen Sie einen neuen MCP-Server hinzu:

{
  "mcpServers": {
    "repliers": {
      "command": "<absolute/path/to/node>",
      "args": ["<absolute/path/to/mcpServer.js>"],
      "env": {
        "REPLIERS_API_KEY": "your-repliers-api-key"
      }
    }
  }
}

Starten Sie Claude Desktop neu, um diese Änderung zu aktivieren. Stellen Sie sicher, dass das neue MCP eingeschaltet ist und einen grünen Kreis daneben hat. Wenn ja, sind Sie bereit, eine Chat-Sitzung zu beginnen, die die von Ihnen verbundenen Tools nutzen kann.

Warnung: Wenn Sie keinen absoluten Pfad zu einer node-Version angeben, die v20+ ist, greift Claude (und andere MCP-Clients) möglicherweise auf eine andere node-Version auf dem System einer früheren Version zurück.

Zusätzliche Optionen

🐳 Docker-Bereitstellung (Produktion)

Für Produktionsbereitstellungen können Sie Docker verwenden:

1. Docker-Image erstellen

docker build -t <your_server_name> .

2. Claude Desktop-Integration

Fügen Sie die Serverkonfiguration zu Claude Desktop hinzu (Settings → Developers → Edit Config):

{
  "mcpServers": {
    "<your_server_name>": {
      "command": "node",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file=.env",
        "<your_server_name>",
        "/ABSOLUTE/PATH/TO/PROJECT/DIRECTORY/mcp-unstructured-partition-demo/"
      ],
      "env": {
        "REPLIERS_API_KEY": "your-repliers-api-key"
      }
    }
  }
}

Fügen Sie Ihre Umgebungsvariablen (API-Schlüssel usw.) in die .env-Datei ein.

Das Projekt wird mit dem folgenden minimalen Docker-Setup geliefert:

FROM node:22.12-alpine AS builder

WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install

COPY . .

ENTRYPOINT ["node", "mcpServer.js"]

🌐 Server-Sent Events (SSE)

Um den Server mit Unterstützung für Server-Sent Events (SSE) auszuführen, verwenden Sie das Flag --sse:

node mcpServer.js --sse

🛠️ Zusätzliche CLI-Befehle

Tools auflisten

Listen Sie Beschreibungen und Parameter aller enthaltenen Tools auf mit:

node index.js tools

Beispiel:

Available Tools:

Workspace: repliers-api
  Collection: property-types-styles.js
    list_property_types_and_styles
      Description: List property types and styles from the Repliers API.
      Parameters:

  Collection: get-deleted-listings.js
    get_deleted_listings
      Description: Retrieve deleted listings from the Repliers API.
      Parameters:
        - updatedOn: The date when the listing was updated.
        - minUpdatedOn: The minimum date for updated listings.
        - maxUpdatedOn: The maximum date for updated listings.

  Collection: areas-cities-and-neighborhoods.js
    list_locations
      Description: List geographical location data such as areas, cities, and neighborhoods.
      Parameters:
        - area: Limits location metadata to areas matching the supplied value.
        - city: Limits location metadata to cities matching the supplied value.
        - class: Limits location metadata to classes matching the supplied value.
        - neighborhood: Limits location metadata to neighborhoods matching the supplied value.
        - search: Limits location metadata to areas, cities, or neighborhoods that match or partially match the supplied value.

  Collection: get-address-history.js
    get_address_history
      Description: Retrieve the MLS history of a specific address.
      Parameters:
        - city: The city of the property.
        - streetName: The street name of the property.
        - streetNumber: The street number of the property.
        - unitNumber: The unit number of the property.
        - streetSuffix: The street suffix of the property.
        - streetDirection: The street direction of the property.
        - zip: The zip code of the property.

  Collection: buildings.js
    repliers_buildings_search
      Description: Search for building data using the Repliers API. Returns information about buildings/complexes rather than individual listings. All parameters including map are sent as query parameters in GET requests.
      Parameters:
        - params: No description
        - pageNum: Page number for pagination (default: 1). If specified loads a specific page in the results set
        - resultsPerPage: Number of buildings to return per page (default: 100, max: 100)

  Collection: get-a-listing.js
    get_listing
      Description: Get a listing using the MLS.
      Parameters:
        - mlsNumber: The MLS number of the listing you wish to retrieve.
        - boardId: Filter by boardId. This is only required if your account has access to more than one MLS.

  Collection: find-similar-listings.js
    find_similar_listings
      Description: Find similar listings using the MLS number.
      Parameters:
        - mlsNumber: The MLS number of the listing to find similar listings for.
        - boardId: Filter by one or more board IDs.
        - fields: Limit the response to specific fields (e.g., "listPrice,soldPrice" or "images[5]").
        - listPriceRange: Returns similar listings within a price range (e.g., 250000 for +/- $250,000).
        - radius: Show similar listings within a specified radius in kilometers.
        - sortBy: Sort similar listings by a specific field (e.g., "updatedOnDesc", "createdOnAsc").

  Collection: search.js
    repliers_listings_search
      Description: Comprehensive property search using Repliers API with all supported parameters. Most parameters are sent as query parameters (GET request). imageSearchItems and map parameters trigger a POST request with body parameters.
      Parameters:
        - params: No description
        - pageNum: Page number for pagination (default: 1)
        - resultsPerPage: Number of results per page (default: 100, max: 100)

Repliers MCP Server