Rentsmart MCP

🚀 RentSmart MCP

このリポジトリには、AI搭載のWhatsAppボットであるRentSmart用の最小限のマルチチャネルプラグイン（MCP）サービスが含まれています。RentSmartは、レンタル契約書や領収書を即座に生成することができます。

✨ 主な機能

• /validate – シンプルなベアラートークンチェックを実行し、ダミーの電話番号を返します。
  デプロイをセキュアにするために、app/main.py内のトークンを更新してください。
• /tool/generate_agreement – レンタル契約書の詳細を受け取り、テキストテンプレートを埋め、PDFに変換して、/files/agreements配下のパブリックリンク経由で返します。
• /tool/generate_rent_receipt – 指定された詳細でPDFの家賃領収書を作成し、/files/receipts配下で公開します。
• /tool/stamp_duty_info – 州ごとの印紙税情報をすばやく参照できるように返します。デモ用にデフォルトの値セットが提供されており、すべてのインドの州を含むように簡単に拡張できます。
• /health – {"status":"ok"}を返すシンプルなハートビートエンドポイントです。

📦 ディレクトリ構造

rentsmart_mcp/
├── app/
│   ├── __init__.py
│   ├── main.py             # FastAPIアプリケーション
│   └── templates/
│       ├── agreement_template.txt
│       └── receipt_template.txt
├── files/                  # 生成されたPDFはここに保存されます
├── requirements.txt        # Pythonの依存関係
└── README.md

🚀 クイックスタート

python -m venv .venv
source .venv/bin/activate  # Windowsの場合は.venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

http://localhost:8000/healthにアクセスして、サーバーが正常に起動していることを確認してください。

🚀 デプロイ

FastAPIをサポートする任意のプラットフォーム（Render、Railway、Vercelまたは独自のサーバー）にデプロイできます。Puch AIとの互換性のために、サービスをHTTPS経由で公開するようにしてください。

🤝 Puch AIとの統合

デプロイ後、WhatsAppチャットで/mcp connectコマンドを使用して、MCPサービスをPuch AIに接続します。以下のURLとトークンをあなたのデプロイ内容に置き換えてください。

/mcp connect https://YOUR-DEPLOYED-URL your_test_token

接続が成功すると、利用可能なツール（generate_agreement、generate_rent_receipt、stamp_duty_info）が表示されます。

🛠️ カスタマイズ

• テンプレート – app/templates内のファイルを編集することで、生成される契約書や領収書のレイアウトと文言をカスタマイズできます。中括弧で囲まれたプレースホルダー（例：{landlord}、{rent}）は、JSONリクエストで提供された値に置き換えられます。
• 印紙税データ – app/main.py内のSTAMP_DUTY_DATA辞書を変更して、正確な州ごとの印紙税料金とリンクを反映させてください。この例には、説明用にいくつかの州が含まれています。
• トークン検証 – app/main.py内のVALID_TOKEN定数を変更して、独自のベアラートークンを適用できます。本番環境では、適切な認証メカニズムを実装する必要があります。

📄 ライセンス

このスターターキットは、ハッカソンや教育目的でそのまま提供されています。ご自身のニーズに合わせて自由に変更および拡張してください。