Stay AI API MCP Server

Stay AI API MCP サーバー

これは、Stay AI の宿泊施設管理 API 用の Model Context Protocol（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
```

次の操作ができるウェブインターフェースが開きます：
- 利用可能なツールとリソースを確認する
- さまざまな入力でツールをテストする
- サーバーのログと応答を確認する

## 利用可能なツール

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