Dafty MCP Server

免责声明

这是一个独立的开源项目，并未与Daft.ie有任何关联、认可或赞助。 此工具仅供教育和实验用途。数据来源于公开网站，其使用需遵守该网站的服务条款。作者不对本软件的使用或误用承担任何责任。请负责任且合乎道德地使用它。

这是一个设计用于与Daft.ie交互的MCP（模型上下文协议）服务器，主要用于通过网络抓取来搜索出租房产。

✨ 特性

• 🔍 搜索出租房产： 根据位置、价格范围、卧室数量和房产类型等不同标准搜索出租房源。此工具使用网络抓取。
• 📄 获取出租房产详情： 尝试根据唯一ID获取特定出租房产的详细信息。
  • 注意： 此工具依赖于官方Daft.ie API（v3），需要API密钥。如果没有有效的密钥（通过环境变量DAFT_API_KEY设置），此工具可能会失败。更多详情及Daft.ie API文档链接，请参阅src/daftApi.ts。

🛠️ 安装

1. 克隆仓库：

   git clone [YOUR_GITHUB_REPO_URL]
   cd dafty-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": {
       "dafty-mcp": {
         "command": "node",
         "args": ["~/dafty-mcp/build/index.js"],
         "env": {},
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }
   

🚀 使用方法

一旦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>