MCP Seat Reservation Server

A server for managing a comprehensive seat reservation system.

座席予約システムの包括的なAPIとやり取りするためのModel Context Protocolサーバーです。オフィス管理、座席予約、コメント機能などを提供します。

- get_offices: 全オフィス一覧を取得
- get_office: 特定オフィスの詳細情報を取得
- get_office_seats: オフィス内の全座席情報を取得

- get_reservations: 予約一覧を取得（日付フィルタリング可能）
- get_reservation: 特定予約の詳細情報を取得
- create_reservation: 新規予約を作成
- update_reservation: 既存予約を更新
- cancel_reservation: 予約をキャンセル

- get_available_seats: 指定期間の利用可能座席を取得
- find_seat_by_number: 座席番号で座席を検索

- get_all_comments: 全コメントを取得
- get_seat_comments: 特定座席のコメントを取得
- add_comment: 座席にコメントを追加
- delete_comment: コメントを削除
- get_comment_counts: 座席ごとのコメント数を取得

mkdir mcp-seat-reservation-server cd mcp-seat-reservation-server

npm install @modelcontextprotocol/sdk npm install --save-dev @types/node typescript

mcp-seat-reservation-server/ ├── src/ │ └── index.ts # メインのサーバーコード ├── package.json ├── tsconfig.json └── README.md

Claude DesktopなどのMCPクライアントで使用する場合、設定ファイルに以下を追加：

{ "mcpServers": { "seat-reservation": { "command": "node", "args": ["/path/to/your/mcp-seat-reservation-server/build/index.js"] } } }

{ "start_date": "2024-01-01", // オプション "end_date": "2024-01-31" // オプション }

{ "user_name": "田中太郎", "seat_id": 1, "start_date": "2024-01-15", "end_date": "2024-01-17" }

{ "reservation_id": 1, "seat_id": 2, "start_date": "2024-01-16", "end_date": "2024-01-18" }

{ "office_id": 1, "start_date": "2024-01-15", "end_date": "2024-01-17" }

{ "office_id": 1, "seat_number": "A1" }

{ "seat_id": 1, "name": "田中太郎", "comment": "この席は快適です！" }

{ "id": 1, "name": "東京本社", "floor": "3F", "layout_data": "{...}" }

{ "id": 1, "office_id": 1, "seat_number": "A1", "position_x": 250, "position_y": 90 }

{ "id": 1, "user_id": 1, "seat_id": 1, "start_date": "2024-01-15", "end_date": "2024-01-17", "created_at": "2024-01-10T10:00:00Z", "user_name": "田中太郎", "seat_number": "A1", "office_name": "東京本社", "floor": "3F" }

{ "id": 1, "seat_id": 1, "name": "田中太郎", "comment": "この席は快適です！", "created_at": "2024-01-10T10:00:00Z", "seat_number": "A1", "office_name": "東京本社", "floor": "3F" }

- GET /api/offices- 全オフィス取得
- GET /api/offices/:id- 特定オフィス取得
- GET /api/offices/:id/seats- オフィスの席一覧取得

- GET /api/reservations- 予約一覧取得
- GET /api/reservations/:id- 特定予約取得
- POST /api/reservations- 予約作成
- PUT /api/reservations/:id- 予約更新
- DELETE /api/reservations/:id- 予約削除

- GET /api/comments- 全コメント取得
- GET /api/seats/:id/comments- 座席のコメント取得
- POST /api/comments- コメント作成
- DELETE /api/comments/:id- コメント削除
- GET /api/seats/comments/count- 座席ごとのコメント数取得

1. get_available_seats で利用可能座席を確認 2. create_reservation で予約を作成 3. get_reservation で予約詳細を確認

1. find_seat_by_number で座席を検索 2. get_seat_comments で座席のコメントを確認 3. add_comment で自分のコメントを追加

1. get_reservations で現在の予約一覧を確認 2. update_reservation で予約を変更 3. cancel_reservation で不要な予約をキャンセル

- APIサーバー（http://localhost:5000）が稼働している必要があります
- Node.js 18以上が必要です
- MCPクライアント（Claude Desktop等）での設定が必要です
- 日付は YYYY-MM-DD 形式で指定してください
- APIサーバーが稼働していることを確認
- ポート番号とURLが正しいことを確認
- ファイアウォールの設定を確認
- 座席が既に予約されていないか確認
- 日付形式が正しいか確認（YYYY-MM-DD）
- 座席IDが存在するか確認
- ビルドが正常に完了していることを確認
- パスが正しいことを確認
- MCPクライアントの設定ファイルを確認

Qasper gives AI agents the tools to discover local service businesses, check availability, and book appointments in real time.