MCP Booking

🚀 レストラン予約MCPサーバー

AI搭載のモデルコンテキストプロトコル（MCP）サーバーで、レストランの検索と予約をサポートします。このサーバーはGoogle Maps Places APIと統合されており、場所、料理の好み、雰囲気、イベントの種類に基づいてレストランを検索し、インテリジェントなレコメンデーションと予約支援を提供します。

✨ 主な機能

🎯 主要機能

• スマートなレストラン検索：高度なフィルタリング機能を使って半径20km以内のレストランを検索します。
• デフォルトの台湾の場所：座標が指定されていない場合、自動的に台湾（24.1501164, 120.6692299）周辺を検索します。
• AIによるレコメンデーション：詳細な理由付きで上位3件のレストランを提案します。
• Google Mapsとの統合：評価、レビュー、写真などの実際のレストランデータを取得できます。
• イベント別のマッチング：デート、家族の集まり、ビジネスミーティング、お祝いなどのイベントに最適化されたレコメンデーションを提供します。
• 雰囲気別のフィルタリング：ロマンチック、カジュアル、高級感、楽しい、静かな雰囲気に合ったレストランを検索できます。
• 予約支援：予約手順の案内とモック予約機能を提供します。

その他の機能

• 🔍 スマートなレストラン検索：場所、料理の種類、雰囲気、イベントの種類に基づいて半径20km以内のレストランを検索します。
• 📍 Google Mapsとの統合：評価、レビュー、写真、連絡先情報などの実際のレストランデータを取得できます。
• 📅 予約支援：空き状況を確認し、予約手順を案内します。
• 🎯 イベント別のマッチング：デート、家族の集まり、ビジネスミーティングなどのイベントに最適化されたレコメンデーションを提供します。
• 🎭 雰囲気別のフィルタリング：希望する雰囲気（ロマンチック、カジュアル、高級感など）に合ったレストランを検索できます。

📦 インストール

前提条件

• Node.js 18+
• Places APIが有効になっているGoogle Maps APIキー
• カスタマイズにはTypeScriptの知識が必要

インストール手順

1. このプロジェクトをクローンまたはダウンロードする

   git clone <repository-url>
   cd mcp-restaurant-booking
   

2. 依存関係をインストールする

   npm install
   

3. 環境変数を設定する

   cp .env.example .env
   

   .env を編集し、Google Maps APIキーを追加します。

   GOOGLE_MAPS_API_KEY=your_actual_api_key_here
   

4. プロジェクトをビルドする

   npm run build
   

Google Maps APIキーの取得方法

1. Google Cloud Consoleにアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. 以下のAPIを有効にします。
   • Places API
   • Maps JavaScript API
   • Geolocation API
   • Places API (New)
   • Geocoding API
4. 認証情報（APIキー）を作成します。
5. セキュリティ上の理由から、APIキーを有効にしたAPIに制限します。

💻 使用例

サーバーの起動

開発モード

npm run dev

本番モード

npm start

利用可能なツール

1. search_restaurants

場所、料理、雰囲気、イベントの種類に基づいてレストランを検索します。 パラメーター

• latitude (数値, オプション): 検索する緯度（デフォルト: 24.1501164 - 台湾）
• longitude (数値, オプション): 検索する経度（デフォルト: 120.6692299 - 台湾）
• placeName (文字列, オプション): 近くを検索する場所の名前（例: "New York", "Tokyo", "London"）。緯度/経度の座標を提供する代わりに使用できます。
• cuisineTypes (文字列配列): 料理の好みの配列
• mood (文字列): 希望する雰囲気
• event (文字列): イベントの種類
• radius (数値, オプション): 検索半径（メートル）（デフォルト: 20000）
• priceLevel (数値, オプション): 価格の好み（1 - 4）

台湾のデフォルトの場所を使用した例

{
  "cuisineTypes": ["Chinese", "Taiwanese"],
  "mood": "casual",
  "event": "family gathering",
  "priceLevel": 2
}

明示的な座標（台北）を使用した例

{
  "latitude": 25.033,
  "longitude": 121.5654,
  "cuisineTypes": ["Italian", "Mediterranean"],
  "mood": "romantic",
  "event": "dating",
  "radius": 15000,
  "priceLevel": 3
}

場所の名前（ニューヨーク）を使用した例

{
  "placeName": "New York, NY",
  "cuisineTypes": ["Italian", "American"],
  "mood": "upscale",
  "event": "business meeting",
  "radius": 10000,
  "priceLevel": 3
}

特定の料理タイプのキーワード検索を使用した例

{
  "keyword": "hotpot",
  "mood": "casual",
  "event": "family gathering",
  "radius": 10000
}

2. get_restaurant_details

特定のレストランの詳細情報を取得します。 パラメーター

• placeId (文字列): レストランのGoogle Places ID

3. get_booking_instructions

予約方法の指示を取得します。 パラメーター

• placeId (文字列): レストランのGoogle Places ID

4. check_availability

予約の空き状況を確認します（モック実装）。 パラメーター

• placeId (文字列): Google Places ID
• dateTime (文字列): ISO形式の希望日時
• partySize (数値): 人数

5. make_reservation

予約を試みます（モック実装）。 パラメーター

• placeId (文字列): Google Places ID
• partySize (数値): 人数
• preferredDateTime (文字列): ISO形式の日時
• contactName (文字列): 予約者の名前
• contactPhone (文字列): 電話番号
• contactEmail (文字列, オプション): メールアドレス
• specialRequests (文字列, オプション): 特別な要求

📚 詳細ドキュメント

仕組み

1. レストランの検索

• Google Places Nearby Search APIを使用して、指定された半径内のレストランを検索します。
• キーワードマッチングを使用して料理の種類でフィルタリングします。
• 各レストランの詳細情報を取得します。

2. AIレコメンデーションエンジン

レコメンデーションシステムは、以下の基準に基づいてレストランにスコアを付けます。

• 評価とレビュー (40%の重み): 評価が高く、レビューが多いほどスコアが高くなります。
• レビュー数 (20%の重み): レビューが多いほど信頼性が高いと判断されます。
• 料理の一致度 (20%の重み): レストランの料理が好みにどれだけ合っているか。
• イベントの適合度 (10%の重み): 指定されたイベントの種類に適しているか。
• 雰囲気の一致度 (10%の重み): 希望する雰囲気との一致度。

3. イベント別のスコアリング

異なるイベントには異なる基準があります。

• デート: 中高級、ロマンチックな料理を好み、ファーストフードは避けます。
• 家族の集まり: 家族向け、予算から中級のオプションを好みます。
• ビジネスミーティング: 静かで、プロフェッショナルで、高級な環境を好みます。
• カジュアルダイニング: 柔軟な基準で、予算に優しいオプションが好まれます。
• お祝い: 高級な特別な会場を好みます。

4. 雰囲気のマッチング

レストランの名前、レビュー、特徴を分析して、雰囲気のキーワードを探します。

• ロマンチック: インティメイト、居心地が良い、キャンドルライト、ワイン
• カジュアル: リラックスした、友好的な、のんびりした
• 高級感: エレガントな、洗練された、高級料理
• 楽しい: 活気がある、エネルギッシュな、活発な
• 静か: 平和な、穏やかな、落ち着いた

開発

プロジェクト構造

src/
├── types/           # TypeScriptの型定義
├── services/        # コアのビジネスロジック
│   ├── googleMapsService.ts      # Google Maps APIの統合
│   ├── restaurantRecommendationService.ts  # AIレコメンデーションエンジン
│   └── bookingService.ts         # 予約ロジック（モック）
└── index.ts         # MCPサーバーの実装

スクリプト

• npm run build: TypeScriptをコンパイルします。
• npm run dev: ホットリロード付きの開発モードで実行します。
• npm start: コンパイルされたバージョンを実行します。
• npm run lint: ESLintを実行します。
• npm run lint:fix: ESLintの問題を修正します。

カスタマイズ

新しい料理の種類を追加する

src/services/googleMapsService.ts の cuisineMap を編集します。

const cuisineMap: { [key: string]: string } = {
  "new_cuisine_type": "Display Name"
  // ... 既存のマッピング
};

レコメンデーションロジックを変更する

src/services/restaurantRecommendationService.ts のスコアリングアルゴリズムを更新します。

• calculateRestaurantScore(): 全体的なスコアリングロジック
• calculateEventSuitability(): イベント別の基準
• calculateMoodMatch(): 雰囲気のマッチングロジック

新しいイベントの種類を追加する

1. src/types/index.ts の event 列挙型を更新します。
2. calculateEventSuitability() メソッドにイベントの基準を追加します。

🔧 技術的な制限事項

• 予約: 現在はモック実装です。実際の予約には、レストラン固有のシステムまたはOpenTableなどのサードパーティサービスとの統合が必要です。
• APIのクォータ: Google Places APIには使用制限とコストがあります。
• リアルタイムデータ: レストランの営業時間と空き状況はリアルタイムではない場合があります。
• 地理的なカバレッジ: Google Places APIがカバーする地域に制限されています。

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合はテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

サポート

問題や質問がある場合は、以下のことを確認してください。

1. Google Maps APIのドキュメントを確認します。
2. APIキーが適切な権限を持っていることを確認します。
3. APIのクォータと請求を確認します。
4. サーバーログを確認してエラーの詳細を確認します。

将来的な機能強化

• [ ] 実際の予約システムの統合（OpenTable、Resyなど）
• [ ] ユーザーの好みの学習
• [x] 多言語対応
• [ ] 高度なフィルタリング（食事制限、アクセシビリティ）
• [ ] カレンダーシステムとの統合
• [x] 価格比較機能
• [ ] ソーシャル機能（レビュー、共有）

追加のブラウザ制御

Browser MCPを使用する

• https://chromewebstore.google.com/detail/browser-mcp-automate-your/bjfgambnhccakkhmkepdoekmckoijdlc
• https://docs.browsermcp.io/setup-server#cursor

サンプル

• プロンプト: - レストランを検索する際に、プロフェッショナルなパーソナルアシスタントとして提供された条件を評価し、選択するために多くの質問をしないで、最適な選択を選び、予約オプションを確認し、予約方法を案内してください。また、そのレストランの特製料理と1人あたりの概算価格も記載してください。予約情報に外部URLを使用した予約URLがある場合は、MCPブラウズツールを使用して予約手順を見つけてください。
• あなたは私の妻とのデートのために、香港の太平洋廣場近くのレストランを予約してくれますか？夕方6時に高級レストランで食事をしたいです。費用は気にせず、ロマンチックな雰囲気が必要です。