Pokemon Vgc Calc MCP

🚀 ポケモンVGCダメージ計算機MCPサーバー

このサーバーは、Model-Context Protocol (MCP) を使用して構築されており、AIエージェントに @smogon/calc パッケージを用いたポケモンのダメージ計算を行うための標準化されたインターフェースを提供します。

🚀 クイックスタート

このサーバーは、ポケモンのダメージ計算を行うための標準化されたインターフェースをAIエージェントに提供します。以下の手順でサーバーをセットアップし、使用することができます。

✨ 主な機能

• MCP準拠サーバー：TypeScriptと公式MCP SDKを使用して構築されています。
• 正確なダメージ計算：コミュニティで検証された @smogon/calc ライブラリを使用して、正確なダメージ計算を行います。
• 包括的な入力処理：ポケモンのステータス、特性、持ち物、技、フィールド条件などの入力を処理します。
• エラーハンドリング：無効なポケモン名、技、入力検証エラーを適切にハンドリングします。
• Vercelデプロイ対応：ゼロコンフィグで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": {}
    }
  }
}

利用可能なツール

サーバーは1つの主要なツール 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

テスト

ローカル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

プロジェクト構造

src/
├── index.ts       # メインのMCPサーバー実装
├── calculator.ts  # ダメージ計算のラッパー
└── types.ts       # TypeScriptの型定義

作者のメッセージ

このプロジェクトの進捗に興味がある場合は、リポジトリをフォローして最新情報を取得してください！

このプロジェクトに関して私に連絡する必要がある場合は、以下のいずれかの方法で自由に連絡してください。

• メール: professor.ragna@gmail.com
• Twitter: @professorragna

このプロジェクトの資金提供に興味がある場合は、こちら から支援することができます。すべての支援を大いに感謝しています！

📄 ライセンス

MIT