Servidor MCP de Repliers

El servidor MCP de Repliers proporciona un conjunto de herramientas para acceder a la API de Repliers en un formato compatible con el Protocolo de Contexto de Modelo (MCP).

La API de Repliers ofrece a los desarrolladores acceso en tiempo real a listados MLS, búsqueda avanzada de propiedades y filtros, entrega de contenido multimedia (imágenes, planos, recorridos), análisis de mercado y herramientas impulsadas por IA como valoraciones instantáneas y alertas. Permite el desarrollo rápido de plataformas inmobiliarias sin necesidad de gestionar infraestructura de backend o integraciones MLS.

Esto le permite utilizar Claude Desktop, o cualquier cliente MCP, para usar lenguaje natural y realizar tareas mediante las herramientas de la API de Repliers, tales como:

"Encuéntrame apartamentos de 3 habitaciones en San Francisco por menos de 1 millón de dólares que hayan estado en el mercado por menos de una semana"
"¿Qué tipos y estilos de propiedad están disponibles en San Francisco?"
"Dame el historial de 123 Main St, San Francisco"
"¿Cuál es el precio de lista medio para casas residenciales en venta en San Francisco agregado por mes en los últimos 20 meses?"

Características

El servidor MCP proporciona las siguientes herramientas para acceder a la API de Repliers.

search - La herramienta de búsqueda es el motor de consulta principal que le permite buscar entre listados de propiedades activas, vendidas o alquiladas utilizando filtros flexibles como:

Ubicación (ciudad, vecindario, coordenadas, etc.)
Rango de precios
Tipo y estilo de propiedad
Habitaciones, baños, tamaño
Estado (activo, vendido, alquilado)
Palabras clave, características (ej. piscina, sótano terminado)
Fecha de listado, indicadores de puertas abiertas
y muchos más

get-a-listing - Obtiene información detallada de un listado de propiedad específico utilizando su ID o número MLS, incluyendo el historial de direcciones

find-similar-listings - Devuelve listados similares a una propiedad determinada según su ubicación, precio, tipo u otros atributos.

get-address-history - Recupera la actividad histórica de listados para una dirección específica, incluyendo ventas previas, alquileres y cambios en los listados.

property-types-styles - Devuelve una lista de referencia de los tipos de propiedad admitidos (ej. condominio, independiente) y estilos arquitectónicos para una junta MLS determinada.

get-deleted-listings - Proporciona acceso a listados que fueron eliminados o borrados recientemente del MLS.

areas-cities-and-neighborhoods - Devuelve un catálogo jerárquico de áreas geográficas, ciudades y vecindarios según lo proporcionado por el MLS.

buildings - Obtiene datos sobre edificios conocidos (ej. condominios o apartamentos), incluyendo nombre, dirección y metadatos.

¡Vamos a configurar todo!

🚦 Primeros pasos

⚙️ Requisitos previos

Antes de comenzar, asegúrese de tener:

Node.js (se requiere v18+, se recomienda v22+)
npm (incluido con Node)

Advertencia: si ejecuta con una versión inferior de Node, es posible que algunas cosas no funcionen como se espera.

📥 Instalación y configuración

1. Instalar dependencias

Ejecute desde el directorio raíz de su proyecto:

npm install

🔐 Establecer variables de entorno de la herramienta

Debe crear un archivo .env en el directorio raíz de su proyecto. Este archivo contendrá la variable de entorno que las herramientas de Repliers utilizarán para autenticarse con las API.

Establezca el valor de REPLIERS_API_KEY con su clave de API de Repliers, la cual puede encontrar en sus claves de API de Repliers. Si no tiene una cuenta, puede crear una en Repliers.

REPLIERS_API_KEY=

Esta variable de entorno se utiliza dentro de las herramientas para establecer la clave de API para cada solicitud. Puede inspeccionar un archivo en el directorio tools para ver cómo funciona.

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

🌐 Probar el servidor MCP con Postman

El servidor MCP (mcpServer.js) expone sus herramientas de API automatizadas a clientes compatibles con MCP, como Claude Desktop o la aplicación de escritorio de Postman. Recomendamos probar el servidor con Postman primero y luego pasar a usarlo con un LLM.

La aplicación de escritorio de Postman es la forma más fácil de ejecutar y probar servidores MCP. Probar el servidor descargado primero es opcional pero recomendado.

Paso 1: Descargue la última versión de la aplicación de escritorio de Postman desde https://www.postman.com/downloads/.

Paso 2: Lea el artículo de documentación aquí y vea cómo crear una solicitud MCP dentro de la aplicación Postman.

Paso 3: Establezca el tipo de solicitud MCP en STDIO y establezca el comando en node </ruta/absoluta/a/mcpServer.js>. Si tiene problemas al usar solo node (por ejemplo, se usa una versión antigua), proporcione una ruta absoluta a una versión de node 20+ en su lugar. Puede obtener la ruta completa a node ejecutando:

which node

Para verificar la versión de node, ejecute:

node --version

Para obtener la ruta absoluta a mcpServer.js, ejecute:

realpath mcpServer.js

Use el comando node seguido de la ruta completa a mcpServer.js como comando para su nueva solicitud MCP de Postman. Luego haga clic en el botón Connect. Debería ver una lista de las herramientas que seleccionó antes de generar el servidor. Puede probar que cada herramienta funcione aquí antes de conectar el servidor MCP a un LLM.

👩💻 Conectar el servidor MCP a Claude

Puede conectar su servidor MCP a cualquier cliente MCP. Aquí proporcionamos instrucciones para conectarlo a Claude Desktop.

Paso 1: Anote la ruta completa a node y al archivo mcpServer.js del paso anterior.

Paso 2. Abra Claude Desktop → Settings → Developers → Edit Config y agregue un nuevo servidor MCP:

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

Reinicie Claude Desktop para activar este cambio. Asegúrese de que el nuevo MCP esté activado y tenga un círculo verde al lado. Si es así, está listo para comenzar una sesión de chat que puede usar las herramientas que ha conectado.

Advertencia: Si no proporciona una ruta absoluta a una versión de node que sea v20+, Claude (y otros clientes MCP) podrían recurrir a otra versión de node en el sistema de una versión anterior.

Opciones adicionales

🐳 Despliegue con Docker (Producción)

Para despliegues en producción, puede usar Docker:

1. Construir imagen de Docker

docker build -t <your_server_name> .

2. Integración con Claude Desktop

Agregue la configuración del servidor a Claude Desktop (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"
      }
    }
  }
}

Agregue sus variables de entorno (claves de API, etc.) dentro del archivo .env.

El proyecto viene incluido con la siguiente configuración mínima de Docker:

FROM node:22.12-alpine AS builder

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

COPY . .

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

🌐 Eventos enviados por el servidor (SSE)

Para ejecutar el servidor con soporte para Server-Sent Events (SSE), use la bandera --sse:

node mcpServer.js --sse

🛠️ Comandos CLI adicionales

Listar herramientas

Liste las descripciones y parámetros de todas las herramientas incluidas con:

node index.js tools

Ejemplo:

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