Pokemon Vgc Calc MCP

🚀 寶可夢VGC傷害計算器MCP服務器

本服務器基於模型上下文協議（MCP）構建，藉助@smogon/calc包為AI智能體提供標準化接口，用於進行寶可夢傷害計算。

🚀 快速開始

本服務器藉助@smogon/calc包，為AI智能體提供了標準化接口，可進行寶可夢傷害計算。你可以按照以下步驟進行安裝和使用。

✨ 主要特性

• 符合MCP標準的服務器：使用TypeScript和官方MCP SDK構建。
• 精準的傷害計算：由社區驗證的@smogon/calc庫提供支持。
• 全面的輸入處理：可處理寶可夢的各項屬性，如基礎數值、特性、攜帶道具、技能以及場地條件等。
• 錯誤處理機制：能對無效的寶可夢名稱、技能和輸入進行驗證和處理。
• 支持Vercel部署：可實現零配置部署。

📦 安裝指南

環境要求

• Node.js 18+
• npm

安裝命令

npm install -g pokemon-vgc-calc-mcp

💻 使用示例

基礎用法

當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

高級用法

你可以在本地開發環境中進行更靈活的配置和測試。

MCP客戶端配置

• 使用遠程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的完整結果對象。

📚 詳細文檔

開發命令

npm run build  # 構建TypeScript項目
npm run test   # 運行測試計算

本地MCP服務器測試

你可以使用MCP Inspector測試本地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

項目結構

src/
├── index.ts       # 主MCP服務器實現
├── calculator.ts  # 傷害計算包裝器
└── types.ts       # TypeScript類型定義

🔧 技術細節

本項目使用TypeScript和官方MCP SDK構建，藉助@smogon/calc庫進行寶可夢傷害計算。通過標準化的MCP接口，為AI智能體提供了統一的調用方式。在輸入處理方面，對寶可夢的各項屬性和場地條件進行了全面的支持，並實現了錯誤處理機制，確保輸入的有效性。

📄 許可證

本項目採用MIT許可證。

作者說明

如果你對本項目的進展感興趣，歡迎關注倉庫以獲取實時更新！

如果你有關於本項目的問題，可通過以下方式聯繫我：

• 發送電子郵件至 professor.ragna@gmail.com
• 在Twitter上聯繫我 @professorragna

如果你有意資助本項目，可以點擊此處支持我。非常感謝你的支持！