Quendoo MCP服务器
Quendoo物业管理系统与Claude Desktop集成的一键安装程序
Quendoo PMS的模型上下文协议（MCP）服务器，具有集成的电子邮件和语音通话功能。
✨ 特性
- 🏨 物业管理 -管理物业、房间、房价
- 📅 可用性检查 -实时可用性查询
- 📦 预订操作 -创建、查看、管理预订
- 📧 电子邮件服务 -向客人发送HTML电子邮件
- 📞 语音呼叫 -自动语音通话，支持文本转语音
- 🔑 API密钥管理 -24小时安全的API密钥缓存
🚀 快速开始
Windows安装（5分钟）
- 下载 这 最新版本
- 提取 到文件夹（例如。，
C:\quendoo-mcp) - 跑
install.bat - 进入 提示时，您的Quendoo API密钥
- 重启 克劳德桌面
- 完成！ 🎉
验证安装
打开克劳德桌面并询问：
Check my Quendoo API key status______________________________________________________________________
📚 文档
- 快速启动.md -5分钟后开始
- 安装.md -详细的安装指南
- 功能.md -完整的功能文档
- API_KEY_SETUP.md -API密钥管理指南
- 部署.md - 🚀 生产部署指南
- 发布_拒绝.md -版本历史
______________________________________________________________________
🔧 需求
______________________________________________________________________
💡 使用示例
检查API密钥状态
Check my Quendoo API key status查询可用性
Show me availability for March 2025获取房间详细信息
What rooms do we have?发送电子邮件
Send email to guest@example.com with subject "Booking Confirmation"进行语音通话
Call +359888123456 and say "Your booking is confirmed"______________________________________________________________________
🏗️ 建筑
本地服务器（推荐）
Claude Desktop → server_simple.py (local) → Quendoo API
↓
API Key Cache (24h)
↓
.env file优点：
- ✅ 简单设置
- ✅ 安全（密钥保持在本地）
- ✅ 快速（无网络跳转）
- ✅ 每个用户都有自己的API密钥
______________________________________________________________________
🔐 安全
- API密钥本地存储在
.env和缓存文件 - 24小时自动缓存过期
- 从未提交给git的密钥（受保护）
.gitignore) - 没有敏感数据的云存储
______________________________________________________________________
📦 包含什么
install.bat-一键式Windows安装程序server_simple.py-主MCP服务器api_key_manager.py-带缓存的API密钥管理tools/-完成Quendoo API集成- 文档-完整的设置和使用指南
______________________________________________________________________
🔄 API密钥管理工具
可通过Claude获取：
set_quendoo_api_key(api_key)-设置API密钥（缓存24小时）get_quendoo_api_key_status()-检查API密钥状态和有效期cleanup_quendoo_api_key()-删除缓存的API密钥
看 API_KEY_SETUP.md 了解详情。
______________________________________________________________________
🛠️ 发展
局部测试
# Install dependencies
pip install -r requirements.txt
# Set your API key
python api_key_manager.py set YOUR_API_KEY
# Test the server
python server_simple.py项目结构
quendoo-mcp/
├── install.bat # Windows installer
├── server_simple.py # Main MCP server
├── api_key_manager.py # API key management
├── tools/ # Quendoo API integration
│ ├── client.py # Quendoo HTTP client
│ ├── property.py # Property tools
│ ├── booking.py # Booking tools
│ ├── availability.py # Availability tools
│ ├── email.py # Email tools
│ └── automation.py # Voice call tools
└── requirements.txt # Python dependencies______________________________________________________________________
🐛 故障排除
服务器未连接？
- 检查Python是否已安装：
python --version - 验证Claude桌面配置：
%APPDATA%\Claude\claude_desktop_config.json - 重新启动克劳德桌面
API密钥已过期？
Set my API key to: YOUR_NEW_KEY需要更多帮助？
______________________________________________________________________
📝 版本历史记录
看 发布_拒绝.md 查看详细的变更日志。
当前版本： v1.0.0-简化安装程序版
______________________________________________________________________
🙏 致谢
内置：
______________________________________________________________________
📄 许可证
\[在此处添加您的许可证\]
______________________________________________________________________
🚀 准备好开始了吗？
- 下载最新版本
- 跑
install.bat - 开始使用Claude和你的Quendoo数据！
问题？ 检查 文档 或者打开一个问题。