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