booking-mcp
booking-mcp
booking-mcp は、Streamable HTTP で提供される、レストランの予約を管理するための Model Context Protocol サーバーです。テーブルの予約、空き状況の確認、予約のキャンセルを行うツールと、予約台帳を読み取るリソース、確認メッセージの下書きを作成するプロンプトを公開します。予約時には、サーバーはユーザーからの聞き取り(elicitation)によってゲストの連絡先情報を収集します。
要件
Python 3.13
Related MCP server: mcp-booking-bridge
使用方法
セットアップ
仮想環境を作成し、SDK(mcp[cli,rich])と依存関係をインストールして、パッケージを編集可能モードでインストールします:
uv syncサーバー
http://127.0.0.1:8000/mcp で Streamable HTTP を提供するサーバーを起動します:
uv run booking-mcpウォークスルー
プロセス内で動作するスタンドアロンの対話型クライアントです。他に起動しておくものは必要ありません。アクションメニューが表示され、聞き取り(elicitation)のプロンプトに自分で答えることができます。
uv run python scripts/walkthrough.py[!TIP]
予約はデフォルトで
var/bookings.jsonに保存されます。別の場所に保存するには、BOOKING_DB_PATHを設定してください:BOOKING_DB_PATH=/tmp/demo.json uv run python scripts/walkthrough.py
MCP サーフェス
種別 | 名前 | 説明 |
ツール |
| ユーザーから氏名、電話番号、備考を聞き取ります |
ツール |
| 予約をキャンセル済みとして記録します |
ツール |
| 指定された時間枠の残りテーブル数を返します |
リソース |
| すべての予約を JSON として返します |
リソース |
| 1件の予約を JSON として返します |
リソース |
| 指定日の各時間枠の容量を JSON として返します |
プロンプト |
| ゲスト向け確認メッセージの下書きを作成します |
構成
booking-mcp/
├── src/booking_mcp/
│ ├── app.py # the shared MCPServer instance
│ ├── config.py # storage path + capacity limits
│ ├── models.py # Reservation domain model
│ ├── store.py # JSON file repository
│ ├── server.py # entrypoint: registers features, runs the server
│ └── features/
│ ├── reservations.py # book/cancel + reservation resources + prompt
│ └── availability.py # availability tool + resource
├── scripts/
│ └── walkthrough.py # manual interactive client
└── var/ # runtime state, gitignored (holds bookings.json)This server cannot be deployed
Maintenance
Related MCP Connectors
Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).
Read availability, reservations, guests; create, change, cancel bookings; add notes in GoTable.
Run your Cluvi AI restaurant: guest chats, reservations, menu and AI receptionist.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables restaurant reservation management through SevenRooms API, allowing users to create reservations and query available time slots with guest details and party size information.-
- AlicenseNot gradedqualityCmaintenanceEnables managing restaurant table bookings through natural language conversations with an AI assistant, with built-in safety measures like no deletion and explicit write enable.MIT
- AlicenseAqualityDmaintenanceEnables AI agents to search restaurants, check availability, and book reservations on OpenTable, including managing booking history and handling multi-factor authentication.9297 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to manage restaurant reservations through typed MCP tools, including checking table availability, creating and canceling reservations, and listing the day's confirmed bookings.-