Restaurante MCP - Ejemplo

Restaurante MCP - サンプル

このリポジトリでは、MCP（Model Context Protocol）、Python、OpenAI GPT を使用した会話型デジタルレストランの例を紹介します。

---

🚀 説明

• 絵文字 🍕🍔 付きのデジタルメニュー
• テーブルごとの注文（同時に最大10テーブルまで対応しますが、任意の数にできます！）
• 注文のクリア、テーブルの変更、ヘルプなどの便利なコマンド
• 決済リンクのモック
• GPT と MCP ツールを活用した会話型クライアント

---

⚡ インストールと初回利用

要件： uv のインストールが必要です（公式インストールガイド）

1. リポジトリをクローンします

git clone https://github.com/Charlytoc/mcp-server-client.git
cd mcp-server-client

2. OpenAI の API KEY を設定します

ルートディレクトリに .env ファイルを作成し、次の内容を追加します。

OPENAI_API_KEY=sk-...

3. プロジェクトを実行します

bash start.sh

このコマンドは次の処理を行います。

• 仮想環境を作成して有効化します（存在しない場合）
• uv を使って依存関係を自動的にインストールします
• 対話型ターミナルでサーバーとクライアントを起動します

---

📝 主な構成

• server.py → レストランのロジックと MCP API
• client.py → 会話型クライアント
• management/menu.csv → 編集可能なメニュー（絵文字も使えます！）
• management/pedidos.csv → テーブルごとの注文（自動生成）
• start.sh → 自動起動スクリプト

---

💡 目的

このプロジェクトの目的は、高度な AI の知識がなくても、MCP を使って簡単に会話型デジタルレストランを作成できることを紹介することです。

---

📋 絵文字付きメニューの例

id,nombre,precio
1,🍕 Pizza,120
2,🍔 Hamburguesa,80
3,🥗 Ensalada,60
4,🍪 Cookie de Oreo,10
5,🥖 Pan de Jamón,30
# ... y más

---

🛠️ メニューをカスタマイズする

management/menu.csv ファイルを編集して、商品を追加、削除、変更できます。
商品名に絵文字を使うと、より視覚的にわかりやすくできます。

---

🧪 利用可能な MCP 機能

• メニューを表示
• 注文を追加
• 注文を削除
• テーブルの注文をクリア
• テーブルの注文を表示
• 会計の合計を計算
• 決済リンクのモックを生成

---

⚠️ 技術的な注意事項

• ポート 8080 が使用中の場合は、次のコマンドで解放できます。
  • netstat -ano | findstr :8080（PID を確認）
  • taskkill /PID <PID> /F（プロセスを終了）
• 仮想環境と依存関係は、uv を使って start.sh が自動的に管理します。
• スクリプトは、uv がない場合にインストール方法を案内するため、オペレーティングシステムを検出します。

---

📣 クレジット

• @Charlytoc による MCP（Model Context Protocol）サンプルプロジェクト
• OpenAI GPT と MCP をベースにしています

---

ご質問やご提案はありますか？
issue を作成するか、Discussions に書き込んでください！

---