Yonder地块搜索MCP服务器
MCP服务器,用于搜索地块和预制房屋,使克劳德能够根据关于价格、大小和附近设施的自然语言查询找到房产。
工具
search_plots
- 根据价格、大小和附近的特征搜索地块
- 可选数字输入:
max_price_eur(数字):最高价格(欧元)min_size_m2(数字):最小地块面积(平方米)- 可选布尔过滤器(检查附近是否存在特征):
near_coastline:地块靠近海岸线near_beach:地块靠近海滩near_airport:地块靠近机场near_main_town:地块靠近一个主要城镇near_public_transport:地块有公共交通通道near_supermarket:地块靠近超市near_convenience_store:地块靠近便利店near_restaurant_or_fastfood:地块靠近餐饮场所near_cafe:地块靠近一家咖啡馆- 返回:最多20个匹配图及其详细信息、富集数据和列表URL
list_prefab_homes
- 根据价格和面积搜索预制房屋
- 可选数字输入:
max_price_eur(数字):最高价格(欧元)min_size_m2(数字):最小房屋面积(平方米)- 可选过滤器:
category(string):按家庭类别筛选- 返回:包含详细信息、图像和平面图的匹配预制房屋列表
查询示例
MCP服务器支持通过以下查询进行自然语言搜索:
- “在附近的超市和咖啡馆给我找5万欧元以下的地块”
- “显示靠近海岸线且有公共交通通道的地块”
- “搜索机场附近1000平方米以上的地块”
- “给我看看10万欧元以下至少8000万平方米的预制房屋”
Claude Desktop的设置和使用
打开终端(Mac)或命令提示符(Windows)并运行以下命令:
- 全局安装Node.js:```bash
Mac (using Homebrew)
brew install node
Windows (using winget)
winget install OpenJS.NodeJS.LTS
1. 设置项目:```bash
# Clone and build
git clone https://github.com/setondji-mn/yonder-mcp-server
cd yonder-mcp-server
npm install
npm run build
# Create .env file
echo "SUPABASE_URL=your_supabase_url
SUPABASE_SERVICE_KEY=your_supabase_service_key
BUBBLE_API_TOKEN=your_bubble_api_token
BUBBLE_HOMES_URL=your_bubble_homes_url" > .env
# Get your project path
pwd # On Mac
cd # On Windows
- 设置Claude桌面:
- 打开克劳德桌面
- 点击克劳德菜单→ 设置→ 开发者→ 编辑配置
- 这将打开:
- 雨衣:
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户:
%APPDATA%\Claude\claude_desktop_config.json - 添加此配置(将FULL_PATH_TO_PROJECT替换为上一步中的路径):```json
{
"mcpServers": {
"yonder_plots": {
"command": "node",
"args": ["FULL_PATH_TO_PROJECT/dist/index.js"],
"cwd": "FULL_PATH_TO_PROJECT",
"env": {
"SUPABASE_URL": "your_supabase_url",
"SUPABASE_SERVICE_KEY": "your_supabase_service_key",
"BUBBLE_API_TOKEN": "your_bubble_api_token",
"BUBBLE_HOMES_URL": "your_bubble_homes_url"
}
}
}
}
- 将凭据值替换为.env文件中的实际值
- 保存文件并重新启动Claude Desktop
- 寻找锤子图标🔨 在右下角
- 点击锤子以验证“yonder_plots”是否已列出
### 故障排除
如果服务器不工作:
1. 检查日志:```bash
# Mac
tail -f ~/Library/Logs/Claude/mcp*.log
# Windows
type "%APPDATA%\Claude\logs\mcp*.log"
- 验证claude_desktop_config.json中的路径是否绝对正确
- 确保.env中的所有凭据都与claude_desktop_config json匹配
许可证
此MCP服务器根据ISC许可证获得许可。有关详细信息,请参阅LICENSE文件。
