How do I use Pokemon MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Pokemon MCP Server compare Pikachu and Charizard stats" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Pokemon MCP Server

A Model Context Protocol (MCP) server that provides Pokemon data through standardized tools. This monorepo contains both the MCP server and data ingestion service for fetching Pokemon data from PokeAPI.

Architecture

This is a PNPM monorepo with two main packages:

pokemon-mcp-server: MCP server that exposes Pokemon data through standardized tools
pokemon-mcp-ingestion: Data ingestion service that fetches from PokeAPI and stores in SQLite

The system uses a shared SQLite database (data/pokemon.sqlite) for Pokemon data storage.

Related MCP server: PocketBase MCP Server

Features

MCP Tools Available

get_pokemon - Get detailed information about a specific Pokemon
search_pokemon - Search Pokemon by name, type, or other criteria
get_strongest_pokemon - Find the strongest Pokemon by various stats
get_pokemon_stats - Get detailed stats for a Pokemon
compare_pokemon - Compare stats between two Pokemon
get_type_effectiveness - Get type effectiveness information

Data Coverage

Complete Pokemon data from PokeAPI
Stats, types, abilities, and more
Type effectiveness relationships
Searchable by multiple criteria

Quick Start

Prerequisites

Node.js 18+
PNPM
Git

Installation

Clone the repository:

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

Install dependencies:

bun install

Set up the database:

./scripts/setup.sh

Build all packages:

bun run build

Usage

Running the MCP Server

# Development mode (with hot reload)
bun run dev

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

Testing with MCP Inspector

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

# CLI testing
bun run inspect:cli

Data Ingestion

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

Claude Desktop Integration

Option 1: NPM Package (Recommended)

Install the server globally:

cd packages/pokemon-mcp-server
bun run build
npm link

Configure Claude Desktop:

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

Option 2: Direct Node Execution

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

Option 3: Development Mode

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

Development

Workspace Commands

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

Server Package Commands

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

Ingestion Package Commands

cd packages/pokemon-mcp-ingestion

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

Testing

The project uses bun's built-in test runner:

# Run all tests
bun run test

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

Database Schema

The SQLite database includes tables for:

pokemon - Basic Pokemon information
stats - Pokemon stats (HP, Attack, Defense, etc.)
types - Pokemon types and relationships
abilities - Pokemon abilities

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests
Run bun run format
Submit a pull request

Commit Guidelines

Use conventional commit format:

<type>[optional scope]: <description>

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

License

MIT License - see LICENSE file for details

Pokemon MCP Server

Pokemon MCP Server

Architecture

Features

MCP Tools Available

Data Coverage

Quick Start

Prerequisites

Installation

Usage

Running the MCP Server

Testing with MCP Inspector

Data Ingestion

Claude Desktop Integration

Option 1: NPM Package (Recommended)

Option 2: Direct Node Execution

Option 3: Development Mode

Development

Workspace Commands

Server Package Commands

Ingestion Package Commands

Testing

Database Schema

Contributing

Commit Guidelines

License

Links

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API