MCP Assistant Playground

🚀 MCP 助手遊樂場

一款基於 Streamlit 的聊天機器人界面，由 OpenAI GPT - 4o 提供支持。它能智能地將用戶輸入路由到自定義 MCP 工具，例如 GPT 聊天、圖像生成、Supabase 查詢和文本轉語音。本項目專為快速實驗 AI 支持的工具路由而構建，靈感源自 Claude 風格的確認流程。

點擊查看相關資源1

點擊查看相關資源2

🚀 快速開始

1. 克隆倉庫

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

2. 設置虛擬環境

python -m venv .venv
source .venv/bin/activate  # 或 `.venv\Scripts\activate` 在 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。

✨ 主要特性

• 使用 GPT - 4o 進行自然語言工具選擇
• 通過 fastmcp 執行 MCP 工具
• 即時 OpenAI 圖像生成（DALL·E 3）
• 文本轉語音音頻合成（GPT - 4o mini TTS）
• Supabase 集成，支持成員 CRUD 操作
• Streamlit UI，帶工具結果渲染（圖像/音頻）

📦 安裝指南

先決條件

• Python 3.10+ 版本
• OpenAI API 密鑰
• Supabase 項目（可選，用於成員工具）

安裝步驟

克隆倉庫

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

設置虛擬環境

python -m venv .venv
source .venv/bin/activate  # 或 `.venv\Scripts\activate` 在 Windows 上

安裝依賴項

pip install -r requirements.txt

設置環境變量

在根目錄下創建一個 .env 文件，包含以下變量：

OPENAI_API_KEY=your_openai_api_key
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

運行應用程序

python launch.py