Stay AI API MCP 服务器

这是一个用于 Stay AI 房产管理 API 的模型上下文协议 (MCP) 服务器。它允许 AI 模型通过标准化的工具和资源与 Stay 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
```

这将打开一个 Web 界面，您可以在其中：
- 浏览可用的工具和资源
- 使用不同的输入测试工具
- 查看服务器日志和响应

## 可用工具

- `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