pokemon-vgc-calc-mcp - 基于MCP协议，用@smogon/calc库实现宝可梦对战精准伤害计算

探索

Pokemon Vgc Calc MCP

基于MCP协议的宝可梦对战伤害计算服务器，使用@smogon/calc库提供精准伤害计算服务

游戏与游戏化开发者工具 #宝可梦计算 #伤害模拟 #MCP服务 .TypeScript

评分 : 2分

下载量 : 6.4K

更新时间 : 2025-07-23

打开站点

什么是Pokémon VGC 损伤计算服务？

这是一个基于Model-Context Protocol (MCP)构建的服务器，为AI代理提供标准化的宝可梦战斗伤害计算接口。使用权威的@smogon/calc库，确保计算结果准确可靠。

如何使用Pokémon VGC 损伤计算服务？

通过MCP客户端（如Claude Desktop或Cursor）连接该服务器，输入攻击方、防守方和技能信息，即可获得详细的伤害计算结果。

适用场景

适用于宝可梦对战分析、训练AI代理进行策略决策、游戏开发测试等场景。

主要功能

精准伤害计算

利用@smogon/calc库进行精确的宝可梦战斗伤害计算，包括随机波动范围和击倒概率

全面参数支持

支持宝可梦属性、能力、道具、招式和场地条件等所有关键参数的输入

错误处理机制

自动检测并提示无效输入，如不存在的宝可梦名称或招式

快速部署支持

支持Vercel一键部署，便于开发者快速集成到自己的项目中

优势

提供高度准确的伤害计算结果

易于集成到各种MCP客户端

支持多种宝可梦战斗场景

具有良好的错误处理机制

局限性

需要基本的MCP配置知识

不支持非标准宝可梦规则

部分高级功能可能需要额外配置

如何使用

安装依赖

确保已安装Node.js 18+ 和npm

安装服务

通过npm全局安装服务包

配置MCP客户端

在MCP客户端中添加本服务作为远程服务器

发送请求

向服务器发送包含攻击方、防守方、招式和场地条件的JSON请求

使用案例

Pikachu对Charizard的Thunderbolt伤害计算

输入Pikachu的属性和装备，计算其使用Thunderbolt对Charizard造成的伤害范围和击倒概率

Chien-Pao对Flutter Mane的Icicle Crash伤害计算

输入Chien-Pao的属性和装备，计算其使用Icicle Crash对Flutter Mane造成的伤害范围和击倒概率

常见问题

我需要哪些技术背景才能使用这个服务？

如何验证我的输入是否正确？

是否支持自定义宝可梦规则？

如何获取帮助？

🚀 Pokémon VGC伤害计算器MCP服务器

这是一个使用模型上下文协议（MCP）构建的服务器，它借助@smogon/calc包为AI智能体提供了一个标准化接口，用于进行宝可梦伤害计算。

✨ 主要特性

符合MCP标准的服务器：使用TypeScript和官方MCP SDK构建。
精确的伤害计算：由社区验证的@smogon/calc库提供支持。
全面的输入处理：可处理宝可梦的各项数据，如属性、特性、携带物品、招式以及场地条件等。
错误处理：能对无效的宝可梦名称、招式和输入进行验证并处理。
支持Vercel部署：零配置即可轻松部署。

📦 安装指南

npm install -g pokemon-vgc-calc-mcp

🚀 快速开始

开发

npm run build  # 构建TypeScript
npm run test   # 运行测试计算

MCP客户端配置

配置你的MCP客户端（如Claude Desktop、Cursor等）：

使用远程npm包：

{
  "mcpServers": {
    "pokemon-calc": {
      "command": "npx",
      "args": ["pokemon-vgc-calc-mcp"],
      "env": {}
    }
  }
}

本地开发：先将仓库克隆到本地，构建项目，然后配置MCP客户端：

$ git clone git@github.com:jpbullalayao/pokemon-vgc-calc-mcp.git
$ npm install
$ npm run build

{
  "mcpServers": {
    "pokemon-calc": {
      "command": "node",
      "args": ["path/to/pokemon-vgc-calc-mcp/dist/index.js"],
      "env": {}
    }
  }
}

可用工具

服务器提供了一个主要工具：calculateDamage

工具：calculateDamage

用于计算攻击方宝可梦和防守方宝可梦之间的战斗伤害。

输入参数：

attacker：宝可梦对象，包含宝可梦的种类、等级、属性、特性、携带物品等信息。
defender：宝可梦对象，包含宝可梦的种类、等级、属性、特性、携带物品等信息。
move：招式对象，包含招式名称和可选的会心一击标志。
field：场地条件，包括天气、地形和副作用等。

输出：

description：人类可读的计算结果。
damage：伤害范围 [最小值, 最大值]。
koChance：击倒概率描述。
fullResult：来自smogon/calc的完整结果对象。

💻 使用示例

基础用法

当MCP客户端调用该工具时，可传入如下参数：

{
  "attacker": {
    "species": "Pikachu",
    "level": 50,
    "ability": "Static", 
    "item": "Light Ball",
    "nature": "Timid",
    "evs": { "spa": 252, "spe": 252, "hp": 4 }
  },
  "defender": {
    "species": "Charizard",
    "level": 50,
    "ability": "Blaze"
  },
  "move": {
    "name": "Thunderbolt"
  },
  "field": {
    "gameType": "Singles"
  }
}

输出：

**252 SpA Light Ball Pikachu Thunderbolt vs. 0 HP / 0 SpD Charizard: 198-234 (107 - 126.4%) -- guaranteed OHKO**

Damage: 198-234
KO Chance: guaranteed OHKO

🔧 技术细节

项目结构

src/
├── index.ts       # 主MCP服务器实现
├── calculator.ts  # 伤害计算包装器
└── types.ts       # TypeScript类型定义

测试

本地MCP服务器测试

你可以使用MCP检查器来测试本地MCP服务器：

npm run build
npx @modelcontextprotocol/inspector node path/to/pokemon-vgc-calc-mcp/dist/index.js

测试输入示例

使用以下输入来测试calculateDamage工具：

{
  "attacker": {
    "species": "Chien-Pao",
    "nature": "Jolly",
    "evs": {
      "atk": 252,
      "spe": 252,
      "hp": 4
    },
    "level": 50
  },
  "defender": {
    "species": "Flutter Mane",
    "nature": "Modest",
    "evs": {
      "hp": 164,
      "def": 100
    },
    "level": 50
  },
  "move": {
    "name": "Icicle Crash"
  },
  "field": {}
}

预期输出

**252 Atk Sword of Ruin Chien-Pao Icicle Crash vs. 164 HP / 100 Def Flutter Mane: 126-148 (83.4 - 98%) -- guaranteed 2HKO**

Damage: 126-148
KO Chance: guaranteed 2HKO