Pokemcp

🚀 Poke - MCP

Poke - MCPは、モデルコンテキストプロトコル（MCP）に基づくサーバーです。標準化されたインターフェースを通じて、ポケモンの情報を提供します。このサーバーはPokeAPIに接続してポケモンのデータを取得し、MCPツールを通じて、Claude Desktop App、Continue、Clineなどの互換性のあるクライアントに情報を提供します。

🚀 クイックスタート

Poke - MCPは、モデルコンテキストプロトコル（MCP）を利用して、AIアプリケーションが外部のツールやデータソースに標準化された方法でアクセスできるようにします。以下に、このサーバーの基本的な使い方を説明します。

✨ 主な機能

• 名前を指定して特定のポケモンの詳細情報を取得する
• ランダムなポケモンを発見する
• 特定の地域（カントー、ジョウト、ホウエンなど）からのランダムなポケモンを探す
• 特定のタイプ（炎、水、電気など）のランダムなポケモンを取得する
• ポケモン情報を取得するための自然言語クエリインターフェースをサポートする

🔧 技術詳細

仕組み

Poke - MCPはモデルコンテキストプロトコルを使用して構築されています。これにより、AIアプリケーションが外部のツールやデータソースに標準化された方法でアクセスできます。このサーバーは以下のように動作します。

1. PokeAPIに接続してポケモンのデータを取得する
2. MCPインターフェースを通じて複数のツールを提供する
3. MCPクライアントからのリクエストを処理する
4. フォーマットされたポケモン情報を返す

MCPツール

サーバーが提供するツールは以下の通りです。

• get - pokemon: 名前に基づいて特定のポケモンの詳細情報を取得する
• random - pokemon: ランダムなポケモンの情報を取得する
• random - pokemon - from - region: 指定された地域からランダムなポケモンを取得する
• random - pokemon - by - type: タイプに基づいてランダムなポケモンを取得する
• pokemon - query: ポケモンに関する自然言語クエリに回答する

アーキテクチャ

サーバーは以下の技術を使用して構築されています。

• TypeScript
• MCP TypeScript SDK (@modelcontextprotocol/sdk)
• Zodを使用した入力検証
• MCP通信に標準I/O伝送を使用

📦 インストール

Smitheryを使用したインストール

Smitheryを通じて、Claude DesktopにPokémcpを自動的にインストールします。

npx -y @smithery/cli install @NaveenBandarage/poke-mcp --client claude

手動インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/poke-mcp.git
cd poke-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

💻 使用例

Claude Desktop Appとの連携

1. Claude Desktop Appをダウンロードしてインストールする
2. Claude Desktopの設定を開く
3. 開発者設定に移動し、設定ファイルを編集する
4. 以下の設定を追加する

{
  "mcpServers": {
    "pokedex": {
      "command": "path/to/poke-mcp/build/index.js"
    }
  }
}

5. Claude Desktopを再起動する
6. これでClaude内でポケモンツールを使用できるはずです

クエリ例

MCPクライアントに接続した後、以下のような質問をすることができます。

• “ピカチュウについて教えて”
• “ランダムなポケモンを教えて”
• “カントー地方のランダムなポケモンを表示して”
• “ランダムな水属性のポケモンは何がある？”

プロジェクト構造

• src/index.ts: メインサーバーの実装
• src/types.ts: TypeScriptのデータ型定義
• package.json: プロジェクトの依存関係とスクリプト
• tsconfig.json: TypeScriptの設定

新機能の追加

新しいツールを追加したり、既存の機能を強化するには、以下の手順に従います。

1. データを取得してフォーマットする新しいヘルパー関数を定義する
2. server.tool()メソッドを使用して新しいツールを登録する
3. リクエストを処理して応答を返すツールロジックを実装する