Dafty MCP

🚀 Dafty MCP Server

このプロジェクトは、Daft.ieとのやり取りを目的としたMCP（Model Context Protocol）サーバーで、主にウェブスクレイピングを通じて賃貸物件の検索を行うことができます。

🚀 クイックスタート

このサーバーを使用する前に、以下の点に注意してください。

このプロジェクトは独立したオープンソースプロジェクトであり、Daft.ieとは関係がありません。また、Daft.ieによる承認や後援を受けていません。 このツールは教育や実験目的でのみ提供されています。データは公開されているウェブサイトからスクレイピングされ、その使用は当該ウェブサイトの利用規約に従う必要があります。作者は、このソフトウェアの使用または誤用について一切の責任を負いません。責任を持って、倫理的に使用してください。

✨ 主な機能

• 🔍 賃貸物件の検索：場所、価格帯、ベッドルームの数、物件の種類など、様々な基準に基づいて賃貸物件を検索できます。このツールはウェブスクレイピングを使用しています。
• 📄 賃貸物件の詳細情報の取得：特定の賃貸物件の一意の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>

📄 ライセンス

このプロジェクトはISCライセンスの下で公開されています。詳細については、こちらを参照してください。