Pokémon Data

🚀 Poke - MCP

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

🚀 クイックスタート

Poke - MCPは、モデルコンテキストプロトコル（MCP）を利用して、AIアプリケーションと外部データソースの標準化されたやり取りを実現します。このサービスを通じて、ポケモンに関する様々な情報を取得できます。

✨ 主な機能

• 名前で特定のポケモンの詳細情報を取得する
• ランダムにポケモンの情報を取得する
• 地域（カロス、ホウエン、シンオウなど）に基づいてランダムなポケモンを取得する
• タイプ（炎、水、電気など）でランダムなポケモンを絞り込む
• 自然言語でポケモンに関する質問に答える

🔧 技術詳細

仕組み

Poke - MCPはモデルコンテキストプロトコルを使用して、AIアプリケーションと外部データソースの標準化されたやり取りを実現します。サービスの流れは以下の通りです：

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

MCPツール

Poke - MCPは以下のツールを提供します：

• get - pokemon：名前から特定のポケモンの詳細情報を取得する
• random - pokemon：ランダムにポケモンの情報を取得する
• random - pokemon - from - region：地域からランダムにポケモンを取得する
• random - pokemon - by - type：タイプからランダムにポケモンを取得する
• pokemon - query：ポケモンに関する自然言語の質問に答える

アーキテクチャ設計

このサービスは以下の技術を使用して構築されています：

• TypeScript
• MCP TypeScript SDK (@modelcontextprotocol/sdk)
• Zodを使用した入力検証
• 標準I/O伝送プロトコルを使用したMCP通信の実装

📦 インストール

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

[Smithery](https://smithery.ai/server/@NaveenBandarage/poke - mcp)を通じて、ClaudeデスクトップアプリにPoke - 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デスクトップアプリでの使用方法

1. Claudeデスクトップアプリをダウンロードしてインストールする
2. Claudeの設定画面を開く
3. 開発者設定に移動し、設定ファイルを編集する
4. 以下の設定を追加する：

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

5. Claudeデスクトップアプリを再起動する
6. これで、Claudeにポケモンツールが統合されているはずです

サンプルクエリ

MCPクライアントに接続した後、以下のコマンドを実行できます：

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

プロジェクト構造

• src/index.ts：メインサービスの実装
• src/types.ts：TypeScriptの型定義ファイル
• package.json：プロジェクトの依存関係とスクリプト情報
• tsconfig.json：TypeScriptの設定ファイル

新機能の拡張

新しいツールを追加したり、既存の機能を強化するには：

1. データを取得して整形するための新しいヘルパー関数を定義する
2. server.tool()メソッドを使用して新しいツールを登録する
3. 具体的なビジネスロジックを実装する

📄 ライセンス

このプロジェクトはMITライセンスに従っています。