Stayai MCP Server

🚀 Stay AI API MCP 服务器

Stay AI API MCP 服务器是一个用于Stay AI物业管理 API 的模型上下文协议（MCP）服务器。它借助标准化工具和资源，让 AI 模型能够与该 API 实现交互，为物业管理提供了高效、便捷的解决方案。

🚀 快速开始

先决条件

• Node.js 16 或更高版本
• 一个 Stay AI API 密钥

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 创建包含你的 Stay AI API 密钥的 .env 文件：

   STAY_AI_API_KEY=your_api_key_here
   

运行服务器

启动服务器：

npm run dev

使用 MCP Inspector 测试

使用 MCP Inspector 测试服务器：

npm run inspect

这将打开一个网络界面，您可以在其中：

• 查看可用工具和资源
• 使用不同输入测试工具
• 查看服务器日志和响应

✨ 主要特性

• 使用各种过滤器搜索物业
• 获取特定物业的详细信息
• 创建、获取、更新和取消预订
• 检查物业的可用性
• 计算停留的价格
• 管理客户档案

📦 安装指南

先决条件

• Node.js 16 或更高版本
• 一个 Stay AI API 密钥

安装步骤

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 创建包含你的 Stay AI API 密钥的 .env 文件：

   STAY_AI_API_KEY=your_api_key_here
   

💻 使用示例

基础用法

// 这里可以根据具体的使用场景添加基础使用代码示例
// 例如调用 search_properties 工具搜索物业
// 假设已经正确引入相关模块和配置好环境
const { search_properties } = require('./your_module_path');
const filters = { /* 定义过滤器 */ };
const result = search_properties(filters);
console.log(result);

高级用法

// 高级场景说明：使用多个工具组合完成复杂业务，比如先搜索物业，再获取其详细信息
const { search_properties, get_property_details } = require('./your_module_path');
const filters = { /* 定义过滤器 */ };
const properties = search_properties(filters);
if (properties.length > 0) {
    const firstPropertyId = properties[0].id;
    const propertyDetails = get_property_details(firstPropertyId);
    console.log(propertyDetails);
}

📚 详细文档

可用工具

• search_properties：使用各种过滤器搜索物业
• get_property_details：获取特定物业的详细信息
• create_booking：为某个物业创建新的预订
• get_booking：获取特定预订的详细信息
• update_booking：更新现有预订
• cancel_booking：取消现有预订
• check_availability：检查物业在特定日期是否可用
• calculate_price：计算停留的价格
• create_customer：创建新的客户档案
• get_customer：获取特定客户的详细信息

可用资源

• property://{id}：获取某个物业的详细信息
• booking://{id}：获取某个预订的详细信息

📄 许可证

本项目采用 MIT 许可证。