Poke MCP

🚀 PokeMCP

PokeMCPは、PokeAPI と統合することで詳細なポケモン情報を提供するMCP（Modular Command Platform）サーバーです。任意のポケモンに関する包括的なデータを取得するツールを提供し、基本ステータス、タイプ、特性（効果付き）、技（効果付き）、進化チェーンを含みます。

🚀 クイックスタート

PokeMCPを使うことで、ポケモンの詳細情報を取得したり、バトルをシミュレートしたりできます。以下のセクションで、インストール方法や使用例、APIの使い方を説明します。

✨ 主な機能

• ポケモンの基本ステータス、タイプ、特性（効果説明付き）を取得します。
• ポケモンごとに最大10個の技を取得し、技の効果も含みます。
• 指定したポケモンの完全な進化チェーンを提供します。
• エラーを適切に処理し、有益なエラーメッセージを返します。

📦 インストール

必要条件

• Python 3.11.4以上
• httpx （非同期HTTPリクエスト用）
• mcp.server.fastmcp （MCPサーバーフレームワーク用）

手順

1. このリポジトリをクローンします：

   git clone https://github.com/ChiragAgg5k/poke-mcp.git
   cd poke-mcp
   

2. uv を使用して依存関係をインストールします：

   uv sync
   

💻 使用例

開発サーバーの起動

uvを使用してサーバーを起動します（必要なMCPインフラがあることを確認してください）：

uv run mcp dev server.py

Claudeとの接続

以下のコマンドを実行してClaudeと接続します：

uv run mcp install server.py

結果は次のように表示されます：

Added server 'poke-mcp' to Claude config   
Successfully installed poke-mcp in Claude app 

これで、Claudeで poke-mcp MCPツールを使用できます：

ポケモン情報の取得

バトルのシミュレート

サーバーをCursorなどの他のMCPクライアントと接続する方法は、こちら を参照してください。

📚 ドキュメント

API

ツール: get_pokemon_info

ポケモンに関する詳細情報を取得します。

引数

• pokemon_name (str): ポケモンの名前（大文字小文字を区別しません）

戻り値

次の構造の辞書を返します：

{
  "name": "pikachu",
  "id": 25,
  "base_stats": {
    "hp": 35,
    "attack": 55,
    ...
  },
  "types": ["electric"],
  "abilities": [
    {"name": "static", "effect": "May paralyze on contact."},
    ...
  ],
  "moves": [
    {"name": "thunder-shock", "effect": "Has a 10% chance to paralyze the target."},
    ...
  ],
  "evolution_chain": ["pichu", "pikachu", "raichu"]
}

エラー処理

ポケモンが見つからない場合やネットワークエラーが発生した場合、レスポンスには説明メッセージ付きの error キーが含まれます。

ツール: simulate_battle

2匹のポケモン間のバトルを、基本的なメカニクス（ステータス、タイプ、状態異常）を使用してシミュレートします。

引数

• pokemon1 (str): 1匹目のポケモンの名前（大文字小文字を区別しません）
• pokemon2 (str): 2匹目のポケモンの名前（大文字小文字を区別しません）

戻り値

次の構造の辞書を返します：

{
  "pokemon1": "pikachu",
  "pokemon2": "charizard",
  "initial_hp": {
    "pikachu": 35,
    "charizard": 78
  },
  "battle_log": [
    "Turn 1:",
    "charizard uses mega-punch and deals 75 damage! (pikachu HP: 0)",
    "pikachu fainted!",
    "Winner: charizard!"
  ],
  "winner": "charizard"
}

エラー処理

どちらかのポケモンが見つからない場合やネットワークエラーが発生した場合、レスポンスには説明メッセージ付きの error キーが含まれます。

📄 ライセンス

このプロジェクトは PokeAPI を使用しており、教育目的および非商用利用を意図しています。