Pokémon AI Demo

Pokémon AI Demo

一个全栈应用，用于探索 Pokémon 数据、比较 Pokémon、推荐克制对象，并使用 AI 生成队伍。系统包含 Django REST API 后端和 React/MUI 前端。

---

目录

• 系统设置与部署
• 可用模块及其用途
• 如何使用队伍构建器
• Web 界面指南
• Agent 集成说明

---

系统设置与部署

前置条件

• Python 3.8+（用于后端）
• Node.js 16+ & npm（用于前端）
• pip（Python 包管理器）

后端设置（Django/DRF）

1. 切换到后端目录：

   cd mcp_server
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 运行迁移：

   python manage.py migrate
   

4. 启动后端服务：

   python manage.py runserver
   

   API 将在 http://127.0.0.1:8000/api/ 上提供服务。

前端设置（React/MUI）

1. 切换到前端目录：

   cd mcp_frontend
   

2. 安装依赖：

   npm install
   npm install @mui/material @emotion/react @emotion/styled
   npm install @mui/icons-material
   
   
   

3. 启动前端服务：

   npm start
   

   应用将在 http://localhost:5173/ 上提供服务。

4. 自动启动应用 -

在终端中运行命令 start.bat（适用于 Windows）

start.sh（适用于 Linux 发行版）

环境变量

• 默认情况下，前端会将后端地址设为 http://127.0.0.1:8000/api/agent/。如有需要，请调整 mcp_frontend/src/App.jsx 中的 API_BASE。

---

dotenv 结构（.env）

• 在 mcpserver 文件夹内创建一个 .env 文件
• 内容 - " POKE_API_URL = "https://pokeapi.co/api/v2/" GOOGLE_API_KEY = "your api key" "

---

可用模块及其用途

后端提供四个主要端点：

1. Pokémon 信息（POST /api/agent/pokemon-info/）

   • 输入：{ "name": "pikachu" }
   • 输出：基本信息、属性值、特性、招式、进化信息和风味文本。

2. 比较 Pokémon（POST /api/agent/compare/）

   • 输入：{ "pokemon1": "pikachu", "pokemon2": "bulbasaur" }
   • 输出：逐项属性值比较、属性克制关系、共有/独有特性。

3. 推荐克制对象（POST /api/agent/strategy/）

   • 输入：{ "name": "charizard" }
   • 输出：弱点和推荐的克制 Pokémon。

4. 队伍构建器（POST /api/agent/team/）

   • 输入：{ "description": "balanced team with fire and water types" }
   • 输出：由 AI 生成的队伍，包含定位和图片。

---

如何使用队伍构建器

• 用途： 根据自然语言描述生成 Pokémon 队伍（例如：“属性覆盖良好的进攻型队伍”）。
• 使用方法：
  1. 前往 Web UI 中的“Generate Team”部分。
  2. 在输入框中填写队伍描述。
  3. 点击“Generate”。
  4. AI 将返回一支 Pokémon 队伍，每个成员都包含名称、定位和图片。
• API 用法：
  • 向 /api/agent/team/ 发送包含 { "description": "your team idea" } 的 POST 请求。
  • 在响应中接收结构化的队伍建议。

---

Web 界面指南

Web 应用分为四个主要卡片：

1. 搜索 Pokémon
   • 输入 Pokémon 名称，查看其属性值、属性类型、特性、招式、进化链和风味文本。
2. 比较两个 Pokémon
   • 输入两个 Pokémon 名称，直观并排比较它们的属性值、属性克制关系和特性。
3. 推荐克制对象
   • 输入 Pokémon 名称，查看其弱点和推荐的克制对象。
4. 生成队伍
   • 描述你想要的队伍，即可获取由 AI 生成、包含定位和图片的队伍。

每个部分都会即时提供反馈、加载指示和错误消息，带来流畅的用户体验。

---

Agent 集成说明

你可以将外部 Agent 或脚本与后端 API 集成。用法示例：

• Python 示例：

  import requests
  response = requests.post('http://127.0.0.1:8000/api/agent/pokemon-info/', json={"name": "pikachu"})
  print(response.json())
  

• 端点：
  • /api/agent/pokemon-info/（POST）
  • /api/agent/compare/（POST）
  • /api/agent/strategy/（POST）
  • /api/agent/team/（POST）
• 请求/响应格式： 所有端点均接受并返回 JSON。

---

许可证

本项目仅用于教育/演示目的，与 Nintendo、Game Freak 或 The Pokémon Company 均无关联。