Repliers MCP Server

Сервер Repliers MCP предоставляет набор инструментов для доступа к API Repliers в формате, совместимом с Model Context Provider (MCP).

API Repliers предоставляет разработчикам доступ в реальном времени к спискам MLS, расширенному поиску и фильтрам недвижимости, доставке медиаконтента (изображения, планы этажей, туры), аналитике рынка и инструментам на базе ИИ, таким как мгновенная оценка стоимости и оповещения. Это позволяет быстро разрабатывать платформы недвижимости без необходимости управления серверной инфраструктурой или интеграциями MLS.

Это позволяет вам использовать Claude Desktop или любой другой MCP-клиент для выполнения задач с помощью инструментов API Repliers на естественном языке, например:

• "Найди мне квартиры с 3 спальнями в Сан-Франциско дешевле 1 миллиона долларов, которые на рынке менее недели"

• "Какие типы и стили недвижимости доступны в Сан-Франциско?"

• "Дай мне историю объекта 123 Main St, Сан-Франциско"

• "Какова медианная цена листинга для жилых домов на продажу в Сан-Франциско, агрегированная по месяцам за последние 20 месяцев?"

Функции

Сервер MCP предоставляет следующие инструменты для доступа к API Repliers.

search — инструмент поиска, который является основным механизмом запросов, позволяющим искать активные, проданные или сданные в аренду объекты недвижимости с использованием гибких фильтров, таких как:

• местоположение (город, район, координаты и т. д.)

• ценовой диапазон

• тип и стиль недвижимости

• количество спален, ванных комнат, площадь

• статус (активный, продан, сдан в аренду)

• ключевые слова, особенности (например, бассейн, готовый подвал)

• дата листинга, флаги открытых просмотров

• и многое другое

get-a-listing — получает подробную информацию о конкретном объекте недвижимости, используя его ID или номер MLS, включая историю адреса

find-similar-listings — возвращает списки объектов, похожих на заданный, на основе местоположения, цены, типа или других атрибутов.

get-address-history — извлекает историю активности листинга для конкретного адреса, включая предыдущие продажи, аренду и изменения в листингах.

property-types-styles — возвращает справочный список поддерживаемых типов недвижимости (например, кондоминиум, отдельно стоящий дом) и архитектурных стилей для заданной доски MLS.

get-deleted-listings — предоставляет доступ к листингам, которые были недавно удалены из MLS.

areas-cities-and-neighborhoods — возвращает иерархический каталог географических областей, городов и районов, предоставленный MLS.

buildings — получает данные об известных зданиях (например, кондоминиумах или многоквартирных домах), включая название, адрес и метаданные.

Давайте приступим к настройке!

🚦 Начало работы

⚙️ Предварительные требования

Перед началом убедитесь, что у вас есть:

• Node.js (требуется v18+, рекомендуется v22+)

• npm (входит в состав Node)

Предупреждение: если вы используете более старую версию Node, некоторые функции могут работать некорректно.

📥 Установка и настройка

1. Установка зависимостей

Запустите из корневого каталога вашего проекта:

npm install

🔐 Установка переменных окружения для инструментов

Вам следует создать файл .env в корневом каталоге вашего проекта. Этот файл будет содержать переменные окружения, которые инструменты Repliers будут использовать для аутентификации в API.

Установите значение REPLIERS_API_KEY равным вашему ключу API Repliers, который можно найти в разделе Repliers API keys. Если у вас нет учетной записи, вы можете создать ее на Repliers.

REPLIERS_API_KEY=

Эта переменная окружения используется внутри инструментов для установки ключа API для каждого запроса. Вы можете изучить файл в каталоге tools, чтобы увидеть, как это работает.

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

🌐 Тестирование сервера MCP с помощью Postman

Сервер MCP (mcpServer.js) предоставляет ваши автоматизированные инструменты API для MCP-совместимых клиентов, таких как Claude Desktop или Postman Desktop Application. Мы рекомендуем сначала протестировать сервер с помощью Postman, а затем переходить к использованию с LLM.

Postman Desktop Application — это самый простой способ запуска и тестирования серверов MCP. Тестирование загруженного сервера сначала является необязательным, но рекомендуется.

Шаг 1: Загрузите последнюю версию Postman Desktop Application с сайта https://www.postman.com/downloads/.

Шаг 2: Прочитайте статью документации здесь и узнайте, как создать запрос MCP внутри приложения Postman.

Шаг 3: Установите тип запроса MCP на STDIO и установите команду node </абсолютный/путь/к/mcpServer.js>. Если у вас возникли проблемы с использованием только node (например, используется старая версия), укажите вместо этого абсолютный путь к версии node 20+.

which node

Чтобы проверить версию node, выполните:

node --version

Чтобы получить абсолютный путь к mcpServer.js, выполните:

realpath mcpServer.js

Используйте команду node, за которой следует полный путь к mcpServer.js, в качестве команды для вашего нового запроса Postman MCP. Затем нажмите кнопку Connect. Вы должны увидеть список инструментов, которые вы выбрали перед созданием сервера. Вы можете проверить работу каждого инструмента здесь, прежде чем подключать сервер MCP к LLM.

👩💻 Подключение сервера MCP к Claude

Вы можете подключить свой сервер MCP к любому клиенту MCP. Здесь мы приводим инструкции по подключению к Claude Desktop.

Шаг 1: Запишите полный путь к node и mcpServer.js из предыдущего шага.

Шаг 2. Откройте Claude Desktop → Settings → Developers → Edit Config и добавьте новый сервер MCP:

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

Перезапустите Claude Desktop, чтобы активировать это изменение. Убедитесь, что новый MCP включен и рядом с ним горит зеленый кружок. Если это так, вы готовы начать сеанс чата, в котором можно использовать подключенные инструменты.

Предупреждение: Если вы не укажете абсолютный путь к версии node v20+, Claude (и другие клиенты MCP) могут вернуться к другой версии node в системе, которая является более старой.

Дополнительные параметры

🐳 Развертывание в Docker (Production)

Для производственного развертывания вы можете использовать Docker:

1. Сборка образа Docker

docker build -t <your_server_name> .

2. Интеграция с Claude Desktop

Добавьте конфигурацию сервера в 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"
      }
    }
  }
}

Добавьте свои переменные окружения (ключи API и т. д.) в файл .env.

Проект поставляется в комплекте со следующей минимальной настройкой Docker:

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)

Чтобы запустить сервер с поддержкой Server-Sent Events (SSE), используйте флаг --sse:

node mcpServer.js --sse

🛠️ Дополнительные команды CLI

Список инструментов

Вывести описания и параметры всех включенных инструментов можно с помощью:

node index.js tools

Пример:

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)