Skip to main content
Glama
deenesjakoruzh
grovesjosephn

Pokemon MCP Server

by grovesjosephn
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

ポケモンMCPサーバー

標準化されたツールを通じてポケモンデータを提供するModel Context Protocol (MCP) サーバーです。このモノレポには、MCPサーバーと、PokeAPIからポケモンデータを取得するためのデータ取り込みサービスの両方が含まれています。

アーキテクチャ

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

  • pokemon-mcp-server: 標準化されたツールを通じてポケモンデータを公開するMCPサーバー

  • pokemon-mcp-ingestion: PokeAPIからデータを取得し、SQLiteに保存するデータ取り込みサービス

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

Related MCP server: PokeMCP

機能

利用可能なMCPツール

  • get_pokemon - 特定のポケモンの詳細情報を取得

  • search_pokemon - 名前、タイプ、その他の条件でポケモンを検索

  • get_strongest_pokemon - さまざまなステータスに基づいて最強のポケモンを検索

  • get_pokemon_stats - ポケモンの詳細ステータスを取得

  • compare_pokemon - 2匹のポケモンのステータスを比較

  • get_type_effectiveness - タイプ相性情報を取得

データ範囲

  • PokeAPIからの完全なポケモンデータ

  • ステータス、タイプ、特性など

  • タイプ相性関係

  • 複数の条件による検索が可能

クイックスタート

前提条件

  • Node.js 18以上

  • PNPM

  • Git

インストール

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

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

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

bun install

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

./scripts/setup.sh

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

bun run build

使用方法

MCPサーバーの実行

# Development mode (with hot reload)
bun run dev

# Production mode
cd packages/pokemon-mcp-server
bun run start

MCP Inspectorでのテスト

# Visual GUI testing
cd packages/pokemon-mcp-server
bun run inspect

# CLI testing
bun run inspect:cli

データ取り込み

# Run data ingestion
cd packages/pokemon-mcp-ingestion
bun run start

Claude Desktopとの統合

オプション1: NPMパッケージ (推奨)

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

cd packages/pokemon-mcp-server
bun run 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": "bun",
      "args": ["/path/to/pokemcp/packages/pokemon-mcp-server/server.ts"],
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

開発

ワークスペースコマンド

bun run build         # Build all packages
bun run dev           # Run all packages in development mode
bun run test          # Run tests for all packages
bun run format        # Format all files
bun run format:check  # Check formatting

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

cd packages/pokemon-mcp-server

bun run build         # Compile TypeScript
bun run dev           # Watch mode
bun run start         # Run server
bun run inspect       # Run MCP Inspector GUI
bun run inspect:cli   # Run MCP Inspector CLI
bun test              # Run tests

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

cd packages/pokemon-mcp-ingestion

bun run build         # Compile TypeScript
bun run dev           # Watch mode
bun run start         # Run ingestion
bun test              # Run tests

テスト

このプロジェクトはbunの組み込みテストランナーを使用しています：

# Run all tests
bun run test

# Run specific package tests
cd packages/pokemon-mcp-server && bun test
cd packages/pokemon-mcp-ingestion && bun test

データベーススキーマ

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

  • pokemon - 基本的なポケモン情報

  • stats - ポケモンのステータス (HP、攻撃、防御など)

  • types - ポケモンのタイプと関係性

  • abilities - ポケモンの特性

コントリビューション

  1. リポジトリをフォークします

  2. フィーチャーブランチを作成します

  3. 変更を加えます

  4. テストを追加します

  5. bun run format を実行します

  6. プルリクエストを送信します

コミットガイドライン

Conventional Commits形式を使用してください：

<type>[optional scope]: <description>

Examples:
- feat(server): add Pokemon evolution chain tool
- fix(ingestion): handle missing species URL gracefully
- docs: update integration guide

ライセンス

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

リンク

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
F
license - not found
Not graded
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • PokeMCP

    ChiragAgg5k
    F
    license
    B
    quality
    D
    maintenance
    An MCP server that provides detailed Pokémon information by integrating with the PokeAPI, allowing users to fetch comprehensive data about Pokémon and simulate battles.
    2
    2

  • PokéAPI MCP Server

    kumaranvpl
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP (Multi-Agent Conversation Protocol) Server that provides an interface to access Pokémon data through the PokéAPI, enabling agents to retrieve information about Pokémon species, abilities, moves, and more via natural language.

  • Poke-MCP

    Jalajil
    F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides comprehensive Pokemon data and battle simulation capabilities to AI assistants. It enables users to access detailed stats, types, and moves while simulating battles with realistic mechanics like type effectiveness and status effects.

View all related MCP servers

Related MCP Connectors

  • mcp

    GibsonAI MCP server: manage your databases with natural language

  • driflyte-mcp-server

    Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

  • Danushkumar-V-mcp-discord

    An MCP server that integrates with Discord to provide AI-powered features.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/grovesjosephn/pokemcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server