repliers-io/mcp-server

API 开发

本页由 AI 翻译，技术细节请以原文为准。查看原文

20 stars 5 forks 质量 82 趋势 30MIT

Repository Install

Repliers API 的开源 MCP 服务器。让开发者在 Repliers 平台上构建对话式和基于代理的房地产应用——自然语言房源搜索、市场营销......

概览

一个MCP（模型上下文协议）服务器，通过Repliers API让像Claude这样的AI助手访问实时MLS数据。使用自然语言搜索房源、拉取市场统计数据并查找房源： - “帮我找到上周在多伦多挂牌价低于80万美元的三居室公寓” - “过去一年波士顿独立住宅按月分组的平均售价是多少？”- “给我MLS号码X12345678的详细信息” 你需要一个回复者API密钥。如果你没有账户，请在 repliers.com 注册。你可以在回复者仪表盘中找到你的API密钥。该Search_Listings工具采用Rereplyers的AI驱动NLP搜索，将自然语言查询转化为列表结果。这需要： 1. 与你的回复者账户关联 2.

概述（AI 翻译）

一个MCP（模型上下文协议）服务器，通过Repliers API让像Claude这样的AI助手访问实时MLS数据。

使用自然语言搜索房源、拉取市场统计数据并查找房源：

“帮我找到多伦多上周挂牌价低于80万美元的三居室公寓”
“过去一年波士顿独立住宅按月分组的平均售价是多少？”
“给我MLS号码X12345678的详细信息”

工具

工具	描述
`Search_Listings`	由Repliers NLP支持的自然语言列表搜索——要求在您的Repliers账户上启用NLP（见下文）
`get_listing`	按MLS号码获取单一房源
`Market_Statistics`	市场统计 — 平均值、中位数、市场天数，按时间或地理分组
`Lookup_Possible_Values`	在运行统计查询

开始之前

回复器 API 密钥

你需要一个回复者API密钥。如果你没有账户，请在 repliers.com 注册。你可以在回复者仪表盘中找到你的API密钥。

为Search_Listings实现自然语言处理

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Repliers MCP Server

An MCP (Model Context Protocol) server that gives AI assistants like Claude access to real-time MLS data via the Repliers API.

Use natural language to search listings, pull market statistics, and look up properties:

“Find me 3 bedroom condos in Toronto under $800k listed in the last week”
“What’s the average sold price for detached homes in Boston grouped by month over the last year?”
“Get me the details for MLS number X12345678”

Tools

Tool	Description
`Search_Listings`	Natural language listing search powered by Repliers NLP — requires NLP to be enabled on your Repliers account (see below)
`get_listing`	Fetch a single listing by MLS number
`Market_Statistics`	Market stats — averages, medians, days on market, grouped by time or geography
`Lookup_Possible_Values`	Enumerate valid filter values (property types, neighborhoods, etc.) before running a statistics query

Before You Start

Repliers API Key

You’ll need a Repliers API key. If you don’t have an account, sign up at repliers.com. You can find your API key in the Repliers dashboard.

Enabling NLP for Search_Listings

The Search_Listings tool uses Repliers’ AI-powered NLP search, which translates natural language queries into listing results. This requires:

An OpenAI API key linked to your Repliers account
NLP enabled on your account

Follow the setup guide here: Utilizing AI-Powered NLP for Real Estate Listing Searches

If NLP isn’t enabled, the other three tools (get_listing, Market_Statistics, Lookup_Possible_Values) will still work fine.

Prerequisites

Node.js — the version in .nvmrc (engine-strict is enabled, so npm install refuses other majors)

npm install

Deployment Options

There are two ways to use this MCP server. Full walkthrough with screenshots: Setting up Repliers MCP (video).

	Hosted (recommended)	Self-hosted
Server to run	none	yours (Node or Docker)
Auth	sign in with your Repliers account	none — API key in the environment
Clients	claude.ai, ChatGPT, any remote-MCP client	Claude Desktop, Postman, any stdio/HTTP client

Option 1 — Repliers Hosted MCP (recommended)

Repliers runs this server at https://mcp.repliers.io. Nothing to install; you link an API key to it and sign in from your client.

1. Link your API key to MCP (self-serve, no support ticket needed):

在 GitHub 查看完整 README

安装

docker run -i --rm --env-file /absolute/path/to/.env repliers-mcp node mcpServer.js

新手？先看 mcpskill.org 教程 →

配置

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