JinDaGe - pokemon-vgc-calc-mcp MCP Details

article

README

🚀 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

📄 许可证

本项目采用MIT许可证。

作者说明

如果你对本项目的进展感兴趣，欢迎关注该仓库以获取实时更新！

如果你有关于本项目的相关问题，可通过以下方式联系我：

发送邮件至 professor.ragna@gmail.com
在Twitter上联系我 @professorragna

如果你有意资助本项目，可以点击这里支持我。任何形式的支持我都万分感激！

pokemon-vgc-calc-mcp