Dafty MCP

🚀 Dafty MCP Server

這是一個獨立的開源項目，旨在與 Daft.ie 進行交互的 MCP（模型上下文協議）服務器，主要用於通過網頁抓取搜索租賃房產信息。

🚀 快速開始

本項目是一個用於與 Daft.ie 交互的 MCP 服務器，以下是使用前的準備步驟：

1. 克隆倉庫：

   git clone [YOUR_GITHUB_REPO_URL]
   cd dafty-mcp
   

2. 安裝依賴：

   npm install
   

3. 構建服務器：

   npm run build
   

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

   npm test
   

以監視模式運行測試： bash npm run test:watch 5. 配置 MCP 設置： 將以下配置添加到你的 MCP 設置文件（例如 ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json）中： json { "mcpServers": { "dafty-mcp": { "command": "node", "args": ["~/dafty-mcp/build/index.js"], "env": {}, "disabled": false, "alwaysAllow": [] } } }

✨ 主要特性

• 🔍 搜索租賃房產：可根據位置、價格範圍、臥室數量和房產類型等多種標準搜索租賃房源，此功能採用網頁抓取技術。
• 📄 獲取租賃房產詳情：嘗試使用特定租賃房產的唯一 ID 檢索其詳細信息。
  • 注意：此工具依賴於 Daft.ie 官方 API（v3），需要 API 密鑰。若未通過 DAFT_API_KEY 環境變量設置有效密鑰，該工具可能無法正常工作。更多詳情和 Daft.ie API 文檔鏈接請參考 src/daftApi.ts。

💻 使用示例

基礎用法

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

• use_mcp_tool，設置 server_name: "dafty-mcp" 和 tool_name: "search_rental_properties"
• use_mcp_tool，設置 server_name: "dafty-mcp" 和 tool_name: "get_rental_property_details"

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

<use_mcp_tool>
<server_name>dafty-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>dafty-mcp</server_name>
<tool_name>get_rental_property_details</tool_name>
<arguments>
{
  "property_id": "1234567"
}
</arguments>
</use_mcp_tool>

📄 許可證

⚠️ 免責聲明

這是一個獨立的開源項目，與 Daft.ie 沒有關聯、未得到其認可或贊助。本工具僅用於教育和實驗目的。數據是從公開可用的網站上抓取的，其使用需遵守該網站的服務條款。作者對本軟件的使用或濫用不承擔任何責任。請負責任且合乎道德地使用。