💬 MCP Assistant Playground

💬 MCP アシスタントのプレイグラウンド

https://github.com/user-attachments/assets/c60a59c0-5ff5-487e-be47-bdcc8253fbc8

https://github.com/user-attachments/assets/85e7453f-950d-41a4-a1f5-1abd3a587067

OpenAI GPT-4o を活用した Streamlit ベースのチャットボットインターフェースです。GPT チャット、画像生成、Supabase クエリ、テキスト読み上げなどのカスタム MCP ツールに、ユーザー入力をインテリジェントにルーティングします。

Claude 風の確認フローに着想を得て、AI を活用したツールのルーティングをすばやく試せるように構築されています。

---

✨ 機能

• GPT-4o を使用した自然言語によるツール選択
• fastmcp による MCP ツールの実行
• OpenAI によるリアルタイムの画像生成（DALL·E 3）
• テキスト読み上げ音声の合成（GPT-4o mini TTS）
• メンバーの CRUD 操作に対応した Supabase 連携
• ツールの結果（画像／音声）を表示する Streamlit UI

---

🛠️ 前提条件

• Python 3.10+
• OpenAI API キー
• Supabase プロジェクト（メンバーツール用、任意）

---

🧪 はじめに

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

git clone https://github.com/niawjunior/mcp-assistant-playground.git
cd mcp-assistant-playground

2. 仮想環境をセットアップする

python -m venv .venv
source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows

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

pip install -r requirements.txt

4. 環境変数を設定する

ルートディレクトリに、次の変数を記述した .env ファイルを作成します。

OPENAI_API_KEY=your_openai_api_key
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

5. アプリケーションを実行する

python launch.py

6. チャットインターフェースにアクセスする

ウェブブラウザーを開き、http://localhost:8501 にアクセスします。

---