💬 MCP Assistant Playground

💬 MCP 助手 Playground

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

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

基于 Streamlit 的聊天机器人界面，由 OpenAI GPT-4o 驱动，可智能地将用户输入路由至自定义 MCP 工具，例如 GPT 聊天、图像生成、Supabase 查询和文本转语音。

该项目旨在快速试验 AI 驱动的工具路由，灵感来自 Claude 风格的确认流程。

---

✨ 功能

• 使用 GPT-4o 通过自然语言选择工具
• 通过 fastmcp 执行 MCP 工具
• 实时 OpenAI 图像生成（DALL·E 3）
• 文本转语音合成（GPT-4o mini TTS）
• 集成 Supabase，支持成员 CRUD 操作
• 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. 访问聊天界面

打开 Web 浏览器并访问 http://localhost:8501。

---