宝可梦数据资源与战斗模拟服务器

该服务是一个提供宝可梦数据资源和战斗模拟工具的MCP服务器,允许大型语言模型查询详细的宝可梦信息并模拟基于回合制的战斗。

  • by AryanAhmadChaudhary
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aryanahmadchaudhary/pokemon-data-resource-and-battle-simulation-mcp-server

使用说明

口袋妖怪数据资源和战斗模拟MCP服务器

该项目实现了一个MCP(模型上下文协议)服务器,为AI模型提供对口袋妖怪数据的访问和一个战斗模拟工具。它允许大型语言模型(LLM)查询全面的口袋妖怪信息,并使用类型效果和状态效果等核心机制模拟回合制战斗。该服务器旨在轻松与Claude桌面应用程序集成。


特性

口袋妖怪数据资源

  • 访问详细的口袋妖怪数据,包括:
    • 基础统计数据(生命值、攻击、防御、特殊攻击、特殊防御、速度)
    • 类型(火、水、草等)
    • 具有效果的能力
    • 可用移动(带描述)
    • 进化链
  • 提供MCP资源接口,将此数据暴露给LLM。

作战模拟工具

  • 模拟任意两个口袋妖怪之间的战斗。
  • 实施核心口袋妖怪战斗机制,包括:
    • 类型有效性计算
    • 使用属性和移动力计算伤害
    • 基于速度统计的转弯顺序
    • 状态效果:瘫痪、烧伤、中毒
  • 提供详细的战斗日志,描述每个行动和结果。
  • 根据哪个口袋妖怪先晕倒来确定获胜者。
  • 作为MCP工具接口公开,供LLM使用。

项目结构

  • server.py -主MCP服务器,带有口袋妖怪数据和战斗模拟工具。
  • pokemon_data.py -从公共PokeAPI获取和处理Pokemon数据。
  • battle_calculations.py -包含伤害、状态效果和类型效果的机制。
  • static_data.py -静态常数,如类型有效性乘数和状态效果。
  • test.py -演示口袋妖怪数据函数和战斗计算使用的示例测试脚本。
  • requirements.txt -运行服务器所需的Python依赖项。

设置和安装

先决条件

  • Python 3.8+
  • 互联网接入查询公共PokeAPI
  • MCP框架(mcp 包装)
  • httpx 用于异步HTTP请求

运行步骤:

  1. 克隆此存储库:
git clone https://github.com/AryanAhmadChaudhary/Pokemon-MCP-Tool.git
  1. 更改到项目根目录(如果尚未在根目录中):
cd Pokemon-Data-Resource-And-Battle-Simulation-MCP-Server
  1. 创建并激活Python虚拟环境
python3 -m venv venv 
source venv/bin/activate
  1. 安装依赖项:
pip install -r requirements.txt
  1. 运行MCP服务器(这将启动MCP检查器UI):
uv run mcp dev server.py

确认MCP检查器已成功打开,您可以与工具进行交互。

  1. 验证MCP配置,并运行以下命令与claude连接:
uv run mcp install server.py
  1. 安装后,您可以直接在克劳德的界面内运行口袋妖怪数据和战斗模拟工具并与之交互。

使用示例

查询口袋妖怪信息

按名称向Claude应用程序询问有关口袋妖怪的详细信息,包括统计数据、类型、能力和进化。

例如:

模拟战斗

请求两个口袋妖怪之间的战斗模拟。服务器将返回详细的战斗日志和获胜者。

例如:

---