使用说明
交互式“数据分析与可视化助手”演示
概要
这是一个演示项目,通过与大型语言模型(LLM)的对话来分析公司内部数据(模拟数据)并生成图表。该项目利用模型上下文协议(MCP),在不直接让LLM访问数据库的情况下,通过定义好的工具实现数据操作。
技术栈
- 前端Next.js(使用TypeScript,App Router),Tailwind CSS
- **Web服务器(MCP客户端)**FastAPI
- MCP服务器FastMCP
- LLMOpenAI GPT-5
- 其他Docker,Docker Compose
设置步骤
1. 前提条件
- 已安装Docker和Docker Compose
- 已安装 Node.js 和 npm(或 yarn)
- 已获取OpenAI API密钥
2. 环境设置
在项目的根目录下 .env 请创建文件并设置您的OpenAI API密钥。
OPENAI_API_KEY="your_openai_api_key_here"
3. 安装前端依赖项
frontend 切换到目录,然后执行以下命令。
cd frontend
npm install
接下来,启动前端的开发服务器。
cd ..
docker compose up -d --build
- 访问应用程序 请打开网页浏览器,访问http://localhost:3000。聊天界面将会显示出来。
使用方法
请在聊天输入框中用自然语言输入有关数据分析和可视化的指令。
问题示例: ·将2025年8月和9月的产品A的销售数据制成柱状图 请告诉我东京分公司的客户年龄段 等。
在本次演示中,为简化操作,一次只能使用一个工具。 因此,无法在一次响应中完成需要多个工具的任务,比如数据获取和图表生成。 另外,根据查询的不同(有一定概率),有时可能会发生错误。