Rentsmart MCP

🚀 RentSmart MCP

RentSmart 是一款由人工智能驅動的 WhatsApp 聊天機器人，可即時生成租賃協議和收據。本倉庫包含了 RentSmart 的一個最小化多通道插件（MCP）服務。

🚀 快速開始

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 以驗證服務器是否正常運行。

✨ 主要特性

• /validate：執行簡單的令牌檢查，並返回一個虛擬電話號碼。你可以在 app/main.py 中更新令牌，以確保部署的安全性。
• /tool/generate_agreement：接收租賃協議的詳細信息，填充文本模板，將其轉換為 PDF 文件，並通過 /files/agreements 下的公共鏈接提供下載。
• /tool/generate_rent_receipt：根據指定的詳細信息創建 PDF 租金收據，並在 /files/receipts 下提供訪問。
• /tool/stamp_duty_info：返回特定州的印花稅信息，方便快速參考。示例中提供了一組默認值，可輕鬆擴展以涵蓋所有印度邦。
• /health：一個簡單的心跳檢查端點，返回 {"status":"ok"}。

📦 安裝指南

1. 創建並激活虛擬環境：

   python -m venv .venv
   source .venv/bin/activate  # 若使用 Windows 系統，請使用 .venv\Scripts\activate
   

2. 安裝依賴：

   pip install -r requirements.txt
   

3. 啟動服務：

   uvicorn app.main:app --reload --port 8000
   

📚 詳細文檔

目錄結構

rentsmart_mcp/
├── app/
│   ├── __init__.py
│   ├── main.py             # FastAPI 應用程序
│   └── templates/
│       ├── agreement_template.txt
│       └── receipt_template.txt
├── files/                  # 生成的 PDF 文件將保存於此
├── requirements.txt        # Python 依賴項
└── README.md

部署

你可以將該服務部署在任何支持 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 常量，以實施你自己的令牌驗證。在生產環境中，你應該實現適當的身份驗證機制。

📄 許可證

本項目作為開源項目提供，可用於黑客馬拉松或教育用途。你可以根據自己的需求自由修改和擴展。