地块搜索服务

用于搜索地块和预制房屋的服务,支持通过自然语言查询价格、大小和附近设施来查找房产。

  • by setondji-mn
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 setondji-mn/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
  2. 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
    
  2. 设置项目:

    # 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
    
  3. 设置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"
    
  2. 验证claude_desktop_config.json中的路径是否绝对正确
  3. 确保.env中的所有凭据都与claude_desktop_config json匹配

许可证

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