使用说明
🧠 代理MCP技术面试官
一个基于人工智能的多智能体技术面试系统，由以下部分构建：
- ⚡ FastAPI（后端API）
- 🤖 CrewAI（代理编排）
- 🔌 MCP服务器（工具执行层）
- 🎨 React+Vite（前端）
- 🧾 报告生成（PDF反馈）
- 📊 代码分析与评估
该项目使用自主AI代理模拟智能技术面试官。
🏗️ 架构概述
该系统由以下部分组成 三军:
- 前端 → React应用程序（用户界面）
- 后端API → FastAPI+CrewAI代理
- MCP服务器 → 工具执行和受控操作
这三个服务必须在开发中同时运行。
🖥️ 系统要求
所需软件
- ✅ python 3.12.8
- ✅ Node.js（LTS）
- ✅ Git
验证安装：
python --version
node -v
npm -v
git --version
# Installation Guide
**Backend Setup**
Ensure your version of Python is 3.13 or Lower
1. Navigate to the backend folder
cd backend
2. Create Virtual Environment
python -m venv venv
3. Activate it
Windows: venv\Scripts\activate
Mac/Linux: source venv/bin/activate
4. Install Dependencies
pip install --upgrade pip
pip install -r requirements.txt
5. Setup Environment Variables
create a .env file inside backend and paste your API key and Model, e.g:
OPENAI_MODEL=gpt-4o-mini
OPENAI_API_KEY=your_openai_key
6. Run the Backend:
uvicorn api:app --reload --port 8000
Your backend should run at:
http://127.0.0.1:8000
**MCP SERVER SETUP**
1. Open a new terminal and go to the mcp-server directory
cd mcp-server
2. Create a Virtual Environment and Activate it
python -m venv venv
venv\Scripts\activate
3. Install Requirements
pip install --upgrade pip
pip install -r requirements.txt
4. Run the Server
uvicorn main:app --port 8001
**Backend Setup**
1. Open a third terminal and install
npm install
2. Run The Front End
npm run dev
The frontend will run on:
http://localhost:5173