Skip to main content
Glama
booking-mcp

booking-mcp

by LuoZihYuan

booking-mcp

booking-mcp は、Streamable HTTP で提供される、レストランの予約を管理するための Model Context Protocol サーバーです。テーブルの予約、空き状況の確認、予約のキャンセルを行うツールと、予約台帳を読み取るリソース、確認メッセージの下書きを作成するプロンプトを公開します。予約時には、サーバーはユーザーからの聞き取り(elicitation)によってゲストの連絡先情報を収集します。

要件

  • Python 3.13

  • uv

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 サーフェス

種別

名前

説明

ツール

book_table(date, time, party_size)

ユーザーから氏名、電話番号、備考を聞き取ります

ツール

cancel_booking(id)

予約をキャンセル済みとして記録します

ツール

check_availability(date, time)

指定された時間枠の残りテーブル数を返します

リソース

bookings://all

すべての予約を JSON として返します

リソース

bookings://{id}

1件の予約を JSON として返します

リソース

availability://{date}

指定日の各時間枠の容量を JSON として返します

プロンプト

confirmation_message(id)

ゲスト向け確認メッセージの下書きを作成します

構成

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)

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables restaurant reservation management through SevenRooms API, allowing users to create reservations and query available time slots with guest details and party size information.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables 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.
    -