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만 달러 미만이고 시장에 나온 지 1주일 미만인 침실 3개짜리 아파트를 찾아줘"

  • "샌프란시스코에서 이용 가능한 매물 유형과 스타일은 무엇인가요?"

  • "샌프란시스코 123 Main St의 이력을 알려줘"

  • "지난 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단계: https://www.postman.com/downloads/에서 최신 Postman 데스크톱 애플리케이션을 다운로드하세요.

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에 연결하기 전에 여기서 각 도구가 작동하는지 테스트할 수 있습니다.

👩💻 Claude에 MCP 서버 연결

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"
      }
    }
  }
}

.env 파일 안에 환경 변수(API 키 등)를 추가하세요.

프로젝트에는 다음과 같은 최소한의 Docker 설정이 포함되어 있습니다:

FROM node:22.12-alpine AS builder

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

COPY . .

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

🌐 SSE (Server-Sent Events)

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