README
🚀 Dafty MCP Server
这是一个独立的开源项目,旨在与 Daft.ie 进行交互的 MCP(模型上下文协议)服务器,主要用于通过网页抓取搜索租赁房产信息。
🚀 快速开始
本项目是一个用于与 Daft.ie 交互的 MCP 服务器,以下是使用前的准备步骤:
- 克隆仓库:
git clone [YOUR_GITHUB_REPO_URL] cd dafty-mcp - 安装依赖:
npm install - 构建服务器:
npm run build - 测试(可选但推荐):
本项目使用 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。
- 注意:此工具依赖于 Daft.ie 官方 API(v3),需要 API 密钥。若未通过
💻 使用示例
基础用法
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 没有关联、未得到其认可或赞助。本工具仅用于教育和实验目的。数据是从公开可用的网站上抓取的,其使用需遵守该网站的服务条款。作者对本软件的使用或滥用不承担任何责任。请负责任且合乎道德地使用。

微信扫一扫