ポケMCP

概要

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

特徴

名前で特定のポケモンの情報を取得する
ランダムなポケモンを発見
特定の地域（カントー、ジョウト、ホウエンなど）からランダムにポケモンを探します
特定のタイプ（火、水、電気など）のポケモンをランダムに入手します。
ポケモン情報の自然言語クエリインターフェース

仕組み

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

PokeAPIに接続してポケモンデータを取得します
MCPインターフェースを通じていくつかのツールを公開します
MCPクライアントからのリクエストを処理する
フォーマットされたポケモン情報を返します

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デスクトップアプリ

Claudeデスクトップアプリをダウンロードしてインストールする
Claudeデスクトップの設定を開く
開発者設定に移動して設定ファイルを編集します
次の構成を追加します。

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

Claudeデスクトップを再起動します
クロードで利用可能なポケモンツールが表示されるはずです

クエリの例

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

「ピカチュウについて教えてください」
「ランダムにポケモンをください」
「カントー地方のポケモンをランダムに表示」
「ランダムウォーターポケモンって何？」

プロジェクト構造

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

新機能の追加

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

データの取得とフォーマットを行うための新しいヘルパー関数を定義する
server.tool() メソッドを使用して新しいツールを登録する
リクエストを処理してレスポンスを返すツールロジックを実装する

ライセンス

ISC

謝辞

ポケモンデータを提供するためのPokeAPI
標準化されたインターフェースのためのモデルコンテキストプロトコル

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

概要

特徴

仕組み