宝可梦AI分析工具

一个全栈应用,用于探索宝可梦数据、比较宝可梦、建议克制宝可梦以及使用AI生成队伍。

  • by GomesAdhikari
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gomesadhikari/pokeapi-mcp

使用说明

口袋妖怪AI演示

一个全方位的应用程序,用于探索神奇宝贝数据、比较神奇宝贝、建议计数器以及使用AI生成团队。该系统具有Django REST API后端和React/MUI前端。


目录


系统设置和部署

先决条件

  • Python 3.8+ (用于后端)
  • Node.js 16+和npm (前端)
  • 点 (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/.

前端设置(反应/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 for(linux发行版)

环境变量

  • 默认情况下,前端期望后端处于 http://127.0.0.1:8000/api/agent/.调整 API_BASE 在……里面 mcp_frontend/src/App.jsx 如果需要的话。

dotenv结构(.env)

  • 在mcpserver文件夹中创建.env文件
  • 内容- " POKE_API_URL=“https://pokeapi.co/api/v2/" GOOGLE_API_KEY=“您的API密钥” "

可用模块及其使用

后端暴露了四个主要端点:

  1. 神奇宝贝信息 (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" }
    • 输出:弱点和推荐的对策宝可梦。
  4. 队伍编辑器 (POST /api/agent/team/)

    • 输入: { "description": "balanced team with fire and water types" }
    • 输出:人工智能生成的带有角色和图像的团队。

如何使用Team Builder

  • 目的: 根据自然语言描述(例如,“具有良好类型覆盖的进攻性团队”)生成一个口袋妖怪团队。
  • 如何使用:
    1. 转到web UI中的“生成团队”部分。
    2. 在输入框中输入您的团队描述。
    3. 点击“生成”。
    4. AI将返回一个口袋妖怪团队,每个团队都有一个名字、角色和图像。
  • API用法:
    • 向发送POST请求 /api/agent/team/ 随着 { "description": "your team idea" }.
    • 在回复中收到结构化的团队建议。

Web界面详解

web应用程序分为四个主要卡片:

  1. 搜寻宝可梦
    • 输入宝可梦名称以查看其属性、类型、能力、移动、进化链和风味文本。
  2. 比较两个神奇宝贝
    • 输入两个宝可梦名称,并排比较它们的属性、类型优势和能力。
  3. 建议计数器
    • 输入宝可梦名称,查看其弱点和建议的对策。
  4. 组建团队
    • 描述你想要的团队,并获得一个由人工智能生成的团队,其中包含角色和图像。

每个部分都提供即时反馈、加载指示器和错误消息,以获得流畅的用户体验。


代理集成说明

您可以将外部代理或脚本与后端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/ (职位)
    • /api/agent/compare/ (职位)
    • /api/agent/strategy/ (职位)
    • /api/agent/team/ (职位)
  • 请求/响应格式: 所有端点都接受并返回JSON。

许可证

本项目用于教育/演示目的,与任天堂、Game Freak或神奇宝贝公司无关。