ai-rotom

ポケモンバトルアドバイザー。

Claude Code, Codex などの AI Agent から MCP ツールとして呼び出し、 ポケモンの種族値・技データ・タイプ相性・ダメージ計算・パーティ分析・選出判断に利用できます。

著作権・商標

本プロジェクトはポケモンのファンメイドツールです。 ポケモンに関する著作権・商標権はすべて権利者に帰属します。

• © Nintendo / Creatures Inc. / GAME FREAK Inc.

• © Pokémon.

• 「ポケットモンスター」「ポケモン」「Pokémon」および関連する名称・ロゴは、任天堂株式会社、株式会社クリーチャーズ、株式会社ゲームフリーク、株式会社ポケモンの商標または登録商標です。

• 「ポケモンチャンピオンズ」および本ツールが対象とするゲームタイトルは上記権利者の著作物です。

本プロジェクトの位置付け

• 本プロジェクトはファンメイド作品 であり、ポケモンの公式商品ではありません。

• 任天堂株式会社、株式会社ポケモン、株式会社クリーチャーズ、株式会社ゲームフリークは、本プロジェクトに関与していません。

• 本プロジェクトは対戦研究・個人利用を目的としており、商用を目的とするものではありません。

ライセンスと権利尊重について

本プロジェクトのソースコードは下記「ライセンス」セクションのとおり MIT License で配布されますが、利用・改変・再配布に際してはポケモンに関する著作権・商標権を最大限尊重してください。

具体的には以下の行為を避けてください:

• ポケモンの公式ツール・公式サービスであるかのように誤認させる表示

• ポケモン関連の著作物（ゲーム画像・音声・ロゴ等）を権利者の許諾なく本プロジェクトに同梱すること

• 権利者の利益を損なう形での商用利用

権利者から連絡をいただいた場合は、速やかに対応します。

Related MCP server: Pokémon VGC Damage Calculator MCP Server

ライセンス

本プロジェクトのソースコードは MIT License で提供されます。 ただし前述のとおり、ポケモンに関する権利は MIT License の対象ではなく、各権利者に帰属します。

クイックスタート

前提

• Node.js >= 24

動作確認

npx -y @nonz250/ai-rotom

標準入出力で MCP プロトコルが動くため、実運用は下記の MCP クライアント経由で行います。

MCP クライアント設定

Claude Code

プロジェクトまたはユーザー設定に追加。

claude mcp add ai-rotom -- npx -y @nonz250/ai-rotom

Codex

プロジェクトまたはユーザー設定に追加。

codex mcp add ai-rotom -- npx -y @nonz250/ai-rotom

利用可能な MCP ツール

プロンプトに入力する言語は日本語・英語どちらでも可能です。

情報取得系

検索系

計算系

分析系

パーティ永続化

自分のパーティ構築を ~/.ai-rotom/parties.json に保存し、セッションをまたいで再利用できる。

パーティ永続化

自分のパーティ構築を ~/.ai-rotom/parties.json に保存し、セッションをまたいで再利用できる。

使用例

AI クライアントに以下のように聞くと、内部でツールが自動で呼ばれます。

「カバルドンの対策候補を教えて」

e.g.) find_counters が呼ばれ、カバルドンの弱点タイプ（みず/くさ/こおり）を攻撃できるポケモン候補と、各候補の双方向ダメ計（候補→カバルドン / カバルドン→候補の全技）・素早さ比較・タイプ相性を返します。受け型か速攻型かといった対策方針の判断は AI が行う前提です。必要に応じてカバルドンの行動をプロンプトに入力し、あくび受けループに対する対策の検討をしてください。

「リザードン、ギャラドス、ピカチュウの 3 体パーティに足りないタイプ耐性は？」

e.g.) analyze_party_weakness が呼ばれ、各タイプを弱点に持つメンバー数（teamWeaknesses）と抜群を取れないタイプ（uncoveredTypes）を返します。致命性の判断は AI が文脈で行います。

既知の制限

• 一部ポケモン未登録: ゲーム本編に登場するポケモンのうち、データとして未登録のものがあります（例: 一部の伝説・地域フォルム等）。順次対応予定。

• 型推定は未対応: 相手の型（性格・持ち物・SP 配分）は明示指定するか、複数型を試行して検証する形になります。

• メタゲーム情報は持ちません: 使用率・流行型等の統計データは扱わないため、AI クライアント側の知識と組み合わせたり、WEB検索をさせて利用してください。

開発者向け

開発・コントリビュート方法・データ編集指針は CLAUDE.md を参照してください。

コントリビュート

• バグ修正・機能追加の PR 大歓迎です

• データの追加・修正も歓迎します

トラブルシューティング

入力エラー: 「ポケモン「XXX」が見つかりません」

• 日本語名の表記ゆれ（半角/全角）が原因の可能性があります

• エラーメッセージに表示される類似候補を参考にしてください

• フォルム違い（例: メガリザードンX / Y）は正式名称で指定してください

「能力ポイント(SP)は各ステータス 32 以下です」

• 従来の EV（252 等）を渡していないか確認してください

• ポケモンチャンピオンズ仕様では 各ステ 0-32 / 合計 0-66 です