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 没有关联、未得到其认可或赞助。本工具仅用于教育和实验目的。数据是从公开可用的网站上抓取的，其使用需遵守该网站的服务条款。作者对本软件的使用或滥用不承担任何责任。请负责任且合乎道德地使用。