PokéAPI とは
PokéAPI は、ポケモンの全データを誰でも無料で使える、世界中のファンと開発者が集まる公開データベースです。種族値・タイプ・特性・技・進化系統・出現地・道具・木の実まで、ゲーム本編に登場するほぼすべての要素を一箇所にまとめて公開しています。
900 種類以上のポケモンと数千件のデータを網羅し、ポケモン関連の Web アプリ・図鑑・対戦シミュレーターの裏側で広く使われている定番リソースです。商用利用も可能で、ポケモンファンの個人開発から学習プロジェクトまで幅広く支えています。
これは公式提供ではなく、有志が作った非公式ツールです。
ポケモンデータ × AI でできること
この MCP サーバーを導入すると、ポケモンの調査・比較・分析を AI への一言で完結できます。
📊 ステータス・技の一括取得
「ピカチュウの種族値と覚える技を全部教えて」
→ HP / 攻撃 / 防御 / 素早さ + 技リスト
⚔️ 対戦戦略の立案支援
「炎タイプで素早さ 100 以上のポケモンをランキング化して」
→ 条件絞り込み + 並び替え
🧬 進化系統の把握
「イーブイの進化系統と各進化条件を一覧で」
→ 9 系統 + 進化条件(友好度・道具・時間帯等)
🎯 タイプ相性の確認
「ガブリアスの弱点タイプと耐性を整理して」
→ ばつぐん・いまひとつ・無効を一覧化
提供される主なツール
PokéAPI MCP Server は、PokéAPI を約 47 ツールとしてラップしています。
| 機能カテゴリ | 主なツール |
|---|---|
| ポケモン本体 | getPokemonByName / getPokemonSpeciesByName / getPokemonFormByName ほか |
| 技 | getMoveByName / getMoveCategoryByName / getMoveDamageClassByName / getMoveTargetByName ほか |
| 道具 | getItemByName / getItemCategoryByName / getItemPocketByName ほか |
| ゲーム要素 | getTypeByName / getStatByName / getAbilityByName / getNatureByName / getEggGroupByName / getGenerationByName ほか |
| 出現・場所 | getLocationByName / getLocationAreaByName / getEncounterMethodByName ほか |
| 進化 | getEvolutionChainById / getEvolutionTriggerByName |
| その他 | getBerryByName(木の実)/ getContestTypeByName(コンテスト)/ getMachineById(わざマシン) |
PokéAPI MCP Server について
PokéAPI MCP Server は、コミュニティ開発者 Asthanaji05 が公開する MCP サーバーです(リポジトリ: Asthanaji05/MCP_Pokemon)。公開 API である PokéAPI をラップし、ポケモン関連のデータすべてを MCP プロトコル経由で取得できるようにしています。JavaScript/Node.js 実装で npx から直接起動できます。
API キー不要・完全無料で動作するため、MCP の入門やプロトタイプ実験にも適しています。ポケモンの種族値・特性・進化・技・道具・出現地・木の実・コンテスト・わざマシンまで網羅し、対戦戦略立案から子どもの学習支援まで幅広く活用できます。
スペック
- 配布形態: npm パッケージ(
pokeapi-mcp-server)+npxランナー - 認証: 不要(公開 API)
- データソース: PokéAPI(v2)
- 提供元: コミュニティ(Asthanaji05)/ ISC
- 対応範囲: ポケモン本体・技・道具・タイプ・特性・進化・出現地・木の実・わざマシンほか約 47 ツール
- 公式リポジトリ: github.com/Asthanaji05/MCP_Pokemon
導入手順
前提条件
- Node.js 20 以上(API キー・認証は不要)
ステップ
- ページ上部のタブから使用環境を選択し、JSON 設定をコピー
- 設定ファイル(
claude_desktop_config.jsonなど)に追記して保存 - クライアントを再起動
動作確認: 「ピカチュウのデータを教えて」と話しかけてみてください。
注意事項
- PokéAPI は非営利の公開 APIです。過度なリクエストは避け、必要に応じてキャッシュを活用してください(利用規約)。
- データはゲーム本編に準拠します。スピンオフ作品や一部最新作のデータは反映されない場合があります。
- ポケモンの名称・画像・キャラクター等の著作権は株式会社ポケモン / 任天堂 / Game Freak / Creatures に帰属します。商用利用時は各種ガイドラインを確認してください。
- 大量の連続クエリを発行するとレート制限の対象になることがあります。バッチ処理用途では PokéAPI のローカルデプロイ手順の併用を検討してください。
設定方法
MCP は、お使いの対応アプリ(クライアント)に下記の設定を貼り付けて使います。 タブからアプリを選び、表示された設定をコピーしてください。
Claude Desktop / Claude Code: Claude Desktop(公式デスクトップアプリ)と Claude Code(公式CLI)は同じ JSON を使います。Desktop は設定ファイルに貼り付け、Claude Code は `.mcp.json` に記述するか `claude mcp add` で追加します。
{
"mcpServers": {
"pokeapi": {
"command": "npx",
"args": ["-y", "pokeapi-mcp-server@1.12.0"]
}
}
}
Cursor: AI 機能を内蔵したコードエディタ(`~/.cursor/mcp.json` に記述)
{
"mcpServers": {
"pokeapi": {
"command": "npx",
"args": ["-y", "pokeapi-mcp-server@1.12.0"]
}
}
}
Cline: VS Code に追加する AI アシスタント拡張(設定画面の MCP Servers から記述)
{
"mcpServers": {
"pokeapi": {
"command": "npx",
"args": ["-y", "pokeapi-mcp-server@1.12.0"]
}
}
}
Gemini CLI: Google の AI CLI。設定形式は Claude Desktop と同じで、`~/.gemini/settings.json` の `mcpServers` に記述するか `gemini mcp add` で追加します。
{
"mcpServers": {
"pokeapi": {
"command": "npx",
"args": ["-y", "pokeapi-mcp-server@1.12.0"]
}
}
}
OpenAI Codex: OpenAI の CLI/IDE。設定は TOML 形式で `~/.codex/config.toml` に記述します(下記は左の JSON から自動変換した参考値です)。
[mcp_servers.pokeapi]
command = "npx"
args = ["-y", "pokeapi-mcp-server@1.12.0"]VS Code: VS Code(GitHub Copilot のエージェント)。`mcp.json` の `servers` キーに記述します(下記は左の JSON から自動変換した参考値です)。
{
"servers": {
"pokeapi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pokeapi-mcp-server@1.12.0"
]
}
}
}※ Gemini CLI は Claude Desktop と同じ mcpServers 形式のため同一の JSON を表示しています。Codex / VS Code タブの設定は、上記 JSON を各公式スキーマ(Codex=~/.codex/config.toml の TOML 形式 / VS Code=mcp.json の servers キー)へ 自動変換した参考値です。貼り付け前にお使いのバージョンの公式ドキュメントもご確認ください。
主なユースケース
- 「ピカチュウの基本ステータスと覚えられる技を全部教えて」と頼むと、ゲーム攻略に必要な情報を整理して返してくれる
- 「炎タイプで素早さが高いポケモンをランキング形式で教えて」と依頼すると、対戦戦略の立案に活用できる
- 子どもの図鑑代わりに「このポケモンの進化系統と進化条件を全部教えて」と聞いて学習補助に使える
- 「ガブリアスとサザンドラの種族値とタイプ相性を比較して、対戦相手にどちらが向いてる?」など意思決定の材料を AI に整理させられる
プラットフォーム別の注意事項
- WindowsNode.js さえ入っていれば追加設定は不要です。
- プロキシ環境社内プロキシ環境では `https://pokeapi.co` へのアクセスを許可してください。
セットアップ・利用上の注意
- 導入・前提バージョンを固定せず `pokeapi-mcp-server` のみ指定すると、お使いの Node.js / npm の組み合わせによっては起動可能なビルドを取得できず「could not determine executable」で失敗することがあります。設定例のように `pokeapi-mcp-server@1.12.0` とバージョンを固定すると確実に起動します(編集部で Node.js 22 / npx 実行・動作確認済み)。