Pokemcp

🚀 ポケモンMCPサーバー

標準化されたツールを通じてポケモンのデータを提供するモデルコンテキストプロトコル（MCP）サーバーです。このモノレポジトリには、MCPサーバーとPokeAPIからポケモンデータを取得するデータ取り込みサービスが含まれています。

🚀 クイックスタート

前提条件

• Node.js 18+
• PNPM
• Git

インストール

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

git clone https://github.com/grovesjosephn/pokemcp.git
cd pokemcp

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

pnpm install

3. データベースをセットアップします：

./scripts/setup.sh

4. すべてのパッケージをビルドします：

pnpm build

使用方法

MCPサーバーを実行する

# 開発モード（ホットリロード付き）
pnpm dev

# 本番モード
cd packages/pokemon-mcp-server
pnpm start

MCPインスペクターでテストする

# ビジュアルGUIテスト
cd packages/pokemon-mcp-server
pnpm inspect

# CLIテスト
pnpm inspect:cli

データ取り込み

# データ取り込みを実行する
cd packages/pokemon-mcp-ingestion
pnpm start

✨ 主な機能

利用可能なMCPツール

• get_pokemon - 特定のポケモンの詳細情報を取得する
• search_pokemon - 名前、タイプ、またはその他の基準でポケモンを検索する
• get_strongest_pokemon - さまざまなステータスで最強のポケモンを見つける
• get_pokemon_stats - ポケモンの詳細なステータスを取得する
• compare_pokemon - 2つのポケモンのステータスを比較する
• get_type_effectiveness - タイプ相性情報を取得する

データカバレッジ

• PokeAPIからの完全なポケモンデータ
• ステータス、タイプ、特性など
• タイプ相性関係
• 複数の基準で検索可能

📚 ドキュメント

アーキテクチャ

これは2つの主要なパッケージを持つPNPMモノレポジトリです：

• pokemon-mcp-server - 標準化されたツールを通じてポケモンデータを公開するMCPサーバー
• pokemon-mcp-ingestion - PokeAPIからデータを取得し、SQLiteに保存するデータ取り込みサービス

システムは、ポケモンデータの保存に共有のSQLiteデータベース（data/pokemon.sqlite）を使用しています。

Claude Desktopとの統合

オプション1: NPMパッケージ（推奨）

サーバーをグローバルにインストールします：

cd packages/pokemon-mcp-server
pnpm build
npm link

Claude Desktopを構成します：

{
  "mcpServers": {
    "pokemon": {
      "command": "pokemon-mcp-server",
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

オプション2: 直接Nodeで実行する

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/pokemcp/packages/pokemon-mcp-server/dist/server.js"],
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

オプション3: 開発モード

{
  "mcpServers": {
    "pokemon": {
      "command": "pnpm",
      "args": ["--filter", "pokemon-mcp-server", "start"],
      "cwd": "/path/to/pokemcp",
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

開発

ワークスペースコマンド

pnpm build         # すべてのパッケージをビルドする
pnpm dev           # すべてのパッケージを開発モードで実行する
pnpm test          # すべてのパッケージのテストを実行する
pnpm lint          # すべてのパッケージをリントする
pnpm format        # すべてのファイルを整形する
pnpm format:check  # 整形をチェックする

サーバーパッケージコマンド

cd packages/pokemon-mcp-server

pnpm build         # TypeScriptをコンパイルする
pnpm dev           # tsxでウォッチモードを実行する
pnpm start         # サーバーを実行する
pnpm inspect       # MCPインスペクターGUIを実行する
pnpm inspect:cli   # MCPインスペクターCLIを実行する
pnpm test          # テストを実行する

取り込みパッケージコマンド

cd packages/pokemon-mcp-ingestion

pnpm build         # TypeScriptをコンパイルする
pnpm dev           # ウォッチモードを実行する
pnpm start         # 取り込みを実行する
pnpm test          # テストを実行する

テスト

このプロジェクトは、テストにVitestを使用しています：

# すべてのテストを実行する
pnpm test

# 特定のパッケージのテストを実行する
pnpm --filter pokemon-mcp-server test
pnpm --filter pokemon-mcp-ingestion test

データベーススキーマ

SQLiteデータベースには以下のテーブルが含まれています：

• pokemon - 基本的なポケモン情報
• stats - ポケモンのステータス（HP、攻撃、防御など）
• types - ポケモンのタイプと関係
• abilities - ポケモンの特性
• type_effectiveness - タイプ相性関係

コントリビュートする

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. テストを追加する
5. pnpm format と pnpm lint を実行する
6. プルリクエストを送信する

コミットガイドライン

コンベンショナルコミット形式を使用してください：

<type>[オプションのスコープ]: <説明>

例:
- feat(server): ポケモンの進化チェーンツールを追加する
- fix(ingestion): 欠落している種URLを適切に処理する
- docs: 統合ガイドを更新する

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🔗 リンク

• モデルコンテキストプロトコル
• PokeAPI
• Claude Desktop