MCP Spend Spotter

NC预算和供应商数据库浏览器

一个基于人工智能的界面，通过自动图形可视化来探索北卡罗来纳州的预算和供应商支付数据。

特性

• AI聊天界面：询问有关NC预算和供应商数据的自然语言问题
• 自动图形生成：SQL查询结果自动显示为图表
• 多接口：通过web前端、CLI或API使用
• 会话管理：每个会话维护对话历史记录
• 暗模式支持：全暗模式主题

快速开始

1.安装后端依赖关系

pip install -r requirements.txt

2.配置后端（根目录下的.env文件）

GROQ_KEY=your_groq_api_key
MODEL_NAME=llama-3.1-8b-instant
FRONTEND_URL=http://localhost:3000
BACKEND_API_KEY=your_secret_key

3.启动后端

cd chat
python api.py

4.安装前端依赖项

cd frontend
npm install

5.配置前端（前端中的.env.local）

BACKEND_URL=http://localhost:8000
BACKEND_API_KEY=your_secret_key

6.启动前端

cd frontend
npm run dev

7.打开浏览器

导航到http://localhost:3000

查询示例

• “2026年，哪些供应商获得的报酬最高？”
• “按支出显示前10家机构”
• “2025财年的总净预算是多少？”
• “按财政年度显示支出”（生成折线图）

CLI使用情况

cd chat
python chat_cli.py

API文档

访问http://localhost:8000/docs当后端正在运行时。

技术

• 后端：FastAPI、Groq（Llama 3.1）、SQLite、Matplotlib
• 前端：Next.js 15、TypeScript、顺风CSS、React Markdown