Poke-MCP

概要

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

Related MCP server: MCP Pokemon Server

特徴

• 名前で特定のポケモンの情報を取得する

• ランダムなポケモンを発見

• 特定の地域（カントー、ジョウト、ホウエンなど）からランダムにポケモンを探します

• 特定のタイプ（火、水、電気など）のポケモンをランダムに入手します。

• ポケモン情報の自然言語クエリインターフェース

仕組み

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

1. PokeAPIに接続してポケモンデータを取得します

2. MCPインターフェースを通じていくつかのツールを公開します

3. MCPクライアントからのリクエストを処理する

4. フォーマットされたポケモン情報を返します

MCPツール

サーバーは次のツールを提供します。

• get-pokemon: 特定のポケモンの名前の詳細情報を取得します

• random-pokemon: ランダムなポケモンの情報を取得する

• random-pokemon-from-region: 特定の地域からランダムにポケモンをゲット

• random-pokemon-by-type: 特定のタイプのポケモンをランダムに入手する

• pokemon-query: ポケモンに関する自然言語クエリに答える

建築

サーバーは以下を使用して構築されます:

• タイプスクリプト

• 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

手動インストール

# Clone the repository
git clone https://github.com/yourusername/poke-mcp.git
cd poke-mcp

# Install dependencies
npm install

# Build the project
npm run build

使用法

Claudeデスクトップアプリ

1. Claudeデスクトップアプリをダウンロードしてインストールする

2. Claudeデスクトップの設定を開く

3. 開発者設定に移動して設定ファイルを編集します

4. 次の構成を追加します。

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

5. Claudeデスクトップを再起動します

6. クロードで利用可能なポケモンツールが表示されるはずです

クエリの例

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

• 「ピカチュウについて教えてください」

• 「ランダムにポケモンをください」

• 「カントー地方のポケモンをランダムに表示」

• 「ランダムウォーターポケモンって何？」

プロジェクト構造

• src/index.ts: メインサーバーの実装

• src/types.ts: ポケモンデータのTypeScript型定義

• package.json: プロジェクトの依存関係とスクリプト

• tsconfig.json: TypeScript の設定

新機能の追加

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

1. データの取得とフォーマットを行うための新しいヘルパー関数を定義する

2. server.tool() メソッドを使用して新しいツールを登録する

3. リクエストを処理してレスポンスを返すツールロジックを実装する

ライセンス

ISC

謝辞

• ポケモンデータを提供するためのPokeAPI

• 標準化されたインターフェースのためのモデルコンテキストプロトコル

このプロジェクトでは、ドメイン固有の知識と機能を使用して AI アシスタントを拡張できるカスタム MCP サーバーを構築する方法を示します。