Guest MCP服务器
](https://www.npmjs.com/package/guesty-mcp-server) 
第一个MCP(模型上下文协议)服务器 格斯特 物业管理。将人工智能代理直接连接到您的Guesty帐户,以管理预订、与客人沟通、跟踪财务和更新定价——所有这些都是自主的。
43工具 涵盖预订、房源、客人、消息、财务、任务、日历、webhooks和定价等等 1个物联网工具 (get_readiness_score)以及 3个企业级聚合器 (get_property_health, submit_checkout_photos, get_maintenance_alerts)用于物业健康汇总、结账照片采集和投资组合维护警报。
想要AI全天候处理您的客人消息吗? 客人Copilot --guest主机的AI访客管理,基于此MCP服务器构建。现在处于测试阶段。
保持更新: 注册以获取发布说明和新工具公告
快速开始
npx guesty-mcp-server或者添加到您的克劳德代码设置中(~/.claude/settings.json):
{
"mcpServers": {
"guesty": {
"command": "npx",
"args": ["-y", "guesty-mcp-server"],
"env": {
"GUESTY_CLIENT_ID": "your-client-id",
"GUESTY_CLIENT_SECRET": "your-client-secret"
}
}
}
}获取Guesty API凭据
- 登录 访客仪表板
- 首选 设置>API (或市场>API证书)
- 使用创建API应用程序
open-api范围 - 复制您的 客户端ID 和 客户端密钥
全部43个工具
预订和客人
| 工具 | 说明 |
|---|---|
get_reservations | 使用过滤器(日期、房源、状态、客人)获取预订 |
create_reservation | 创建直接预订(网站到Guesty) |
update_reservation | 更新预订状态、日期、客人信息或添加备注 |
search_reservations | 按客人姓名、电子邮件或确认码搜索 |
get_reservation_financials | 预订的详细财务明细 |
create_reservation_note | 在预订中添加内部备注 |
get_guests | 按姓名或电子邮件搜索访客数据库 |
get_guest_by_id | 获取详细的客人资料 |
列表和日历
| 工具 | 说明 |
|---|---|
get_listing | 获取房产详细信息或列出所有房产 |
update_listing | 更新标题、描述、设施、最低入住天数、最多入住人数 |
get_calendar | 按日期查看可用性和价格 |
update_calendar | 阻止/取消阻止日期,设置最低住宿天数 |
get_calendar_blocks | 获取被阻止的日期及其原因 |
get_listing_occupancy | 计算某一日期范围内的入住率 |
get_photos | 获取带有标题的列表照片 |
update_photos | 替换或重新排序列表照片 |
消息传递
| 工具 | 说明 |
|---|---|
get_conversations | 获取访客消息历史记录 |
send_guest_message | 在对话中向客人发送消息 |
财务与定价
| 工具 | 说明 |
|---|---|
get_financials | 收入、支出和佣金数据 |
update_pricing | 更新基础价格或特定日期的定价 |
get_listing_pricing | 获取基本价格、折扣和费用详细信息 |
update_listing_pricing | 更新基本价格、清洁费、折扣 |
get_owner_statements | 所有者收入报表和报告 |
get_expenses | 跟踪运营费用 |
create_expense | 创建新的支出记录 |
get_revenue_summary | 所有上市公司的总收入 |
运营
| 工具 | 说明 |
|---|---|
get_tasks | 获取清洁和维护任务 |
create_task | 创建清洁或维护任务 |
get_reviews | 从所有渠道获取客人评论 |
respond_to_review | 发布对客人评论的回复 |
get_channels | 列出每个酒店的连接预订渠道 |
get_supported_languages | 获取列表支持的语言 |
自动化与集成
| 工具 | 说明 |
|---|---|
get_automation_rules | 列出自动化和工作流规则 |
get_webhooks | 列出已注册的webhooks |
create_webhook | 注册新的webhook以获取事件通知 |
delete_webhook | 删除已注册的webhook |
get_custom_fields | 获取列表或预订的自定义字段 |
get_account_info | 获取帐户信息和订阅详细信息 |
企业级
| 工具 | 说明 |
|---|---|
get_property_health | 每个酒店的汇总健康信号:预订状态、开放维护警报、审核分数、上次清洁时间戳、物联网中心状态 |
submit_checkout_photos | 接受退房后上传的照片,并将其记录在酒店的维护/清洁记录中 |
get_maintenance_alerts | 列出或筛选物业或投资组合的开放维护警报 |
需要 GUESTY_MCP_LICENSE_KEY 使用Enterprise密钥(gmcp_ent_*).看 定价.
用例
- 客人沟通:AI代理使用真实的预订数据自动回复客人的询问
- 收入管理:提取财务报告,分析入住率,优化定价
- 运营:跟踪入住/退房情况,协调清洁时间表,管理可用性
- 营销:确定低入住率时段,制定有针对性的促销活动
- 多代理团队:让您的整个人工智能团队访问房产数据
需求
- Node.js 18+
- 具有API访问权限的Guesty帐户(专业计划或更高级别)
- MCP兼容的AI客户端(Claude Code、Cursor、Windsurf等)
环境变量
| 变量 | 默认值 | 用途 |
|---|---|---|
GUESTY_CLIENT_ID | -- | OAuth2客户端id(必需) |
GUESTY_CLIENT_SECRET | -- | OAuth2客户端机密(必需) |
IOT_WEBHOOK_PORT | 3100 | 企业级IoT webhook接收器存根的端口(src/webhook/iot-receiver-server.js).仅限本地/反向代理——不要公开。生产需要一个反向代理来终止TLS并对其强制执行真正的HMAC IOT_WEBHOOK_SECRET. |
API 参考
此服务器包装 Guesty Open API身份验证使用带有自动令牌缓存、重试逻辑和速率限制处理的OAuth2客户端凭据流。
建造于
DLJ属性 --与完全自主的AI代理团队一起运营7个物业。专为我们自己使用而构建,与STR社区共享。
许可证
麻省理工学院
