使用说明
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:
# Mac (using Homebrew) brew install node # Windows (using winget) winget install OpenJS.NodeJS.LTS -
设置项目:
# 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替换为上一步中的路径):
{ "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”是否已列出
故障排除
如果服务器不工作:
- 检查日志:
# 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文件。