Daft Ie MCP

🚀 Daft.ie MCP 服務器

這是一個 MCP（模型上下文協議）服務器，專為與 Daft.ie 交互而設計，主要用於通過網頁抓取搜索租賃房產信息。

✨ 主要特性

• 搜索租賃房產：可根據多種條件（如位置、價格範圍、臥室數量和房產類型）搜索租賃房源。此工具使用網頁抓取技術。
• 獲取租賃房產詳情：嘗試使用特定租賃房產的唯一 ID 檢索其詳細信息。

  ⚠️ 重要提示

  此工具依賴於 Daft.ie 官方 API（v3），該 API 需要 API 密鑰。如果沒有有效的密鑰（通過 DAFT_API_KEY 環境變量設置），此工具可能會失敗。更多詳情和 Daft.ie API 文檔鏈接請參考 src/daftApi.ts。

📦 安裝指南

1. 克隆倉庫：

   git clone [YOUR_GITHUB_REPO_URL]
   cd daft-ie-mcp
   

2. 安裝依賴項：

   npm install
   

3. 構建服務器：

   npm run build
   

4. 測試（可選但推薦）： 本項目使用 Vitest 進行單元測試。運行測試：

   npm test
   

   以監視模式運行測試：

   npm run test:watch
   

5. 配置 MCP 設置： 將以下配置添加到您的 MCP 設置文件中（例如，~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json）：

   {
     "mcpServers": {
       "daft-ie-mcp": {
         "command": "node",
         "args": ["~/daft-ie-mcp/build/index.js"],
         "env": {},
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }
   

💻 使用示例

基礎用法

MCP 服務器配置並運行後，您可以使用以下工具：

• use_mcp_tool，其中 server_name: "daft-ie-mcp" 且 tool_name: "search_rental_properties"
• use_mcp_tool，其中 server_name: "daft-ie-mcp" 且 tool_name: "get_rental_property_details"

示例：搜索都柏林的租賃房產

<use_mcp_tool>
<server_name>daft-ie-mcp</server_name>
<tool_name>search_rental_properties</tool_name>
<arguments>
{
  "location": "Dublin",
  "min_price": 1000,
  "max_price": 2000,
  "num_beds": 2
}
</arguments>
</use_mcp_tool>

示例：獲取特定房產的詳細信息

<use_mcp_tool>
<server_name>daft-ie-mcp</server_name>
<tool_name>get_rental_property_details</tool_name>
<arguments>
{
  "property_id": "1234567"
}
</arguments>
</use_mcp_tool>