Skip to main content
Glama
mickmath86

Repliers MCP Server

by mickmath86

Repliers MCPサーバー

Repliers MCPサーバーは、Repliers APIにアクセスするためのツールセットを、Model Context Provider (MCP) 互換形式で提供します。

Repliers APIは、MLS物件情報、高度な物件検索とフィルタリング、メディア配信(画像、間取り図、ツアー)、市場分析、および即時査定やアラートなどのAI駆動型ツールへのリアルタイムアクセスを開発者に提供します。これにより、バックエンドインフラストラクチャやMLS統合を管理することなく、不動産プラットフォームを迅速に開発できます。

これを使用すると、Claude Desktopや任意のMCPクライアントで、自然言語を使ってRepliers APIツールを介して以下のような操作が可能になります:

  • 「サンフランシスコで、100万ドル以下、3ベッドルームのアパートで、市場に出てから1週間以内の物件を探して」

  • 「サンフランシスコで利用可能な物件タイプとスタイルは何ですか?」

  • 「123 Main St, San Franciscoの履歴を教えて」

  • 「サンフランシスコで販売されている住宅の過去20ヶ月間の月別中央値リスト価格は?」

機能

Repliers APIにアクセスするための以下のツールがMCPサーバーによって提供されます。

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で実行すると、一部の機能が期待通りに動作しない場合があります。

📥 インストールとセットアップ

1. 依存関係のインストール

プロジェクトのルートディレクトリから実行します:

npm install

🔐 ツール環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成する必要があります。このファイルには、RepliersツールがAPI認証に使用する環境変数を保持します。

REPLIERS_API_KEY の値を、Repliers APIキーで確認できるRepliers APIキーに設定してください。アカウントをお持ちでない場合は、Repliersで作成できます。

REPLIERS_API_KEY=

この環境変数は、各リクエストのAPIキーを設定するためにツール内で使用されます。tools ディレクトリ内のファイルを検査して、どのように動作するかを確認できます。

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

🌐 PostmanでMCPサーバーをテストする

MCPサーバー (mcpServer.js) は、自動化されたAPIツールをClaude DesktopやPostmanデスクトップアプリケーションなどのMCP互換クライアントに公開します。まずはPostmanでサーバーをテストし、その後にLLMで使用することをお勧めします。

Postmanデスクトップアプリケーションは、MCPサーバーを実行およびテストする最も簡単な方法です。ダウンロードしたサーバーを最初にテストすることはオプションですが、推奨されます。

ステップ 1: 最新のPostmanデスクトップアプリケーションを https://www.postman.com/downloads/ からダウンロードします。

ステップ 2: こちら のドキュメント記事を読み、Postmanアプリ内でMCPリクエストを作成する方法を確認します。

ステップ 3: MCPリクエストのタイプを STDIO に設定し、コマンドを node </absolute/path/to/mcpServer.js> に設定します。node だけの使用で問題がある場合(例:古いバージョンが使用されるなど)、代わりにNode 20+への絶対パスを指定してください。Nodeのフルパスは以下を実行して取得できます:

which node

Nodeのバージョンを確認するには、以下を実行します:

node --version

mcpServer.js への絶対パスを取得するには、以下を実行します:

realpath mcpServer.js

新しいPostman MCPリクエストのコマンドとして、nodeコマンドの後に mcpServer.js へのフルパスを指定します。次に Connect ボタンをクリックします。サーバー生成前に選択したツールリストが表示されるはずです。MCPサーバーをLLMに接続する前に、ここで各ツールが動作することを確認できます。

👩💻 MCPサーバーをClaudeに接続する

MCPサーバーを任意のMCPクライアントに接続できます。ここでは、Claude Desktopに接続する手順を説明します。

ステップ 1: 前のステップで確認したNodeと mcpServer.js へのフルパスをメモします。

ステップ 2. Claude Desktop → SettingsDevelopersEdit 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がオンになっており、横に緑色の円が表示されていることを確認してください。そうであれば、接続したツールを使用できるチャットセッションを開始する準備ができています。

警告: v20+の node バージョンへの絶対パスを指定しない場合、Claude(および他のMCPクライアント)はシステム上の以前のバージョンの node にフォールバックする可能性があります。

その他のオプション

🐳 Dockerデプロイメント (本番環境)

本番環境へのデプロイには、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)
A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mickmath86/repliers-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server