Yonder MCP Server

Yonder地块搜索MCP服务器

MCP服务器，用于搜索地块和预制房屋，使克劳德能够根据关于价格、大小和附近设施的自然语言查询找到房产。

工具

1. 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

1. list_prefab_homes

- 根据价格和面积搜索预制房屋 - 可选数字输入： - max_price_eur （数字）：最高价格（欧元） - min_size_m2 （数字）：最小房屋面积（平方米） - 可选过滤器： - category （string）：按家庭类别筛选 - 返回：包含详细信息、图像和平面图的匹配预制房屋列表

查询示例

MCP服务器支持通过以下查询进行自然语言搜索：

• “在附近的超市和咖啡馆给我找5万欧元以下的地块”
• “显示靠近海岸线且有公共交通通道的地块”
• “搜索机场附近1000平方米以上的地块”
• “给我看看10万欧元以下至少8000万平方米的预制房屋”

Claude Desktop的设置和使用

打开终端（Mac）或命令提示符（Windows）并运行以下命令：

1. 全局安装Node.js：

   # Mac (using Homebrew)
   brew install node

   # Windows (using winget)
   winget install OpenJS.NodeJS.LTS

1. 设置项目：

   # 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

1. 设置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”是否已列出

故障排除

如果服务器不工作：

1. 检查日志：

   # Mac
   tail -f ~/Library/Logs/Claude/mcp*.log

   # Windows
   type "%APPDATA%\Claude\logs\mcp*.log"

1. 验证claude_desktop_config.json中的路径是否绝对正确
2. 确保.env中的所有凭据都与claude_desktop_config json匹配

许可证

此MCP服务器根据ISC许可证获得许可。有关详细信息，请参阅LICENSE文件。