Poke MCP

🚀 ポケモンMCPサーバー

このサーバーは、PokeAPIを通じてポケモンデータへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバーです。Claudeやその他のMCP互換クライアントが、ポケモンのステータス、タイプ、技、進化チェーンなどの詳細情報を取得できるようになります。

✨ 主な機能

• ポケモン概要：ポケモンの名前、タイプ、基本ステータス、説明を含む包括的な情報を取得します。
• 技の詳細：ポケモンの技に関する詳細情報（威力、PP、タイプ、ダメージクラスなど）を取得します。
• 進化チェーン：任意のポケモンの完全な進化チェーンを取得します。

📦 インストール

前提条件

• Node.js 18以上
• npmまたはyarnパッケージマネージャー

手順

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

git clone <your-repository-url>
cd pokemon-mcp

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

npm install

3. プロジェクトをビルドします：

npm run build

💻 使用例

開発環境での実行

サーバーを開発モードで実行するには：

npm run dev

本番環境での実行

ビルド後、コンパイルされたサーバーを実行できます：

node build/index.js

利用可能なツール

1. ポケモン概要の取得

• ツール名：get_pokemon_overviews
• 説明：複数のポケモンの概要情報を取得します。
• パラメーター：
  • pokemonNames：ポケモン名の配列（例：['pikachu', 'charizard']）
• 戻り値：各ポケモンの名前、タイプ、基本ステータス、説明

2. 技の詳細情報の取得

• ツール名：get_move_detail
• 説明：特定のポケモンの技に関する詳細情報を取得します。
• パラメーター：
  • move：技の名前（例：'hyper beam', 'thunder bolt'）
• 戻り値：技の名前、威力、PP、タイプ、カテゴリ、ダメージクラス

3. 進化チェーンの取得

• ツール名：get_evolution_chain
• 説明：ポケモンの完全な進化チェーンを取得します。
• パラメーター：
  • pokemonName：ポケモン名（例：'bulbasaur'）
• 戻り値：基本形から最終進化形までの完全な進化チェーン

Claude Desktopとの接続

このMCPサーバーをClaude Desktopで使用するには、Claude Desktopの設定で構成する必要があります。

設定

1. Claude Desktopを開きます。
2. 設定 → 開発者 → 設定の編集に移動します。
3. claude_desktop_config.jsonに以下の設定を追加します：

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/your/pokemon-mcp/build/index.js"],
      "env": {}
    }
  }
}

重要：/path/to/your/pokemon-mcp/を実際のプロジェクトディレクトリの絶対パスに置き換えてください。

代替案：npxを使用する場合（公開されている場合）

これをnpmパッケージとして公開している場合は、以下のように使用できます：

{
  "mcpServers": {
    "pokemon": {
      "command": "npx",
      "args": ["pokemon-mcp"],
      "env": {}
    }
  }
}

確認

1. 設定を更新した後、Claude Desktopを再起動します。
2. Claudeインターフェースに🔌アイコンが表示され、MCPサーバーが接続されていることを示します。
3. 利用可能なMCPサーバーとして「pokemon」が表示されるはずです。
4. Claudeにポケモンの情報を尋ねることで接続をテストします。

Claudeでの使用例

接続後、Claudeに以下のような質問をすることができます：

• 「ピカチュウとリザードンに関する情報を取得できますか？」
• 「10万ボルトの技の詳細は何ですか？」
• 「フシギダネの進化チェーンを見せてください」
• 「フシギダネ、ヒトカゲ、ゼニガメのステータスを比較してください」

APIデータソース

このサーバーは、無料でオープンなポケモンAPIであるPokeAPIからデータを取得します。サーバーにはキャッシュが含まれており、パフォーマンスを向上させ、API呼び出しを減らします。このプロジェクトでは、具体的にポケモン図鑑Promise v2を使用しています。

プロジェクト構造

pokemon-mcp/
├── src/
│   ├── index.ts          # メインのMCPサーバー実装
│   └── pokemonHelper.ts  # ポケモンAPIのヘルパー関数
├── build/                # コンパイルされたJavaScript出力
├── package.json
├── tsconfig.json
└── README.md

開発用スクリプト

• npm run dev - ホットリロードを使用してサーバーを開発モードで実行します。
• npm run build - TypeScriptをJavaScriptにコンパイルします。

依存関係

• @modelcontextprotocol/sdk - MCPサーバーを構築するためのMCP SDK
• pokedex-promise-v2 - プロミスベースのPokeAPIラッパー
• zod - スキーマ検証ライブラリ

トラブルシューティング

サーバーが接続されない場合

• Claude Desktopの設定に記載されているパスが正しく、絶対パスであることを確認してください。
• ビルドディレクトリが存在し、コンパイルされたJavaScriptが含まれていることを確認してください。
• Node.jsがインストールされており、コマンドラインからアクセス可能であることを確認してください。

ポケモンが見つからない場合

• ポケモンの名前が正しく入力されていることを確認してください（大文字と小文字は区別されません）。
• 公式のポケモン名を使用してください（例：メスのニドランは「nidoran-f」）。

技が見つからない場合

• 技の名前にはスペースではなくハイフンを使用してください（例：「hyper-beam」は「hyper beam」ではなく）。
• サーバーは自動的にスペースをハイフンに変換しますが、正しい形式を使用することをお勧めします。

📄 ライセンス

ISC

コントリビューション

問題や機能改善のリクエストを自由に提出してください！