Labsco
grovesjosephn logo

Pokemon

★ 4

from grovesjosephn

Provides access to a comprehensive Pokemon database through a standardized MCP interface.

🔥🔥🔥✓ VerifiedFreeAdvanced setup
#database#git

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.

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

Claude Desktop Integration

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