poke_mcp

t-daiki96/poke_mcp

3.2

If you are the rightful owner of poke_mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Pokémon MCP Server is a Model Context Protocol server that provides Pokémon stats and images using the PokeAPI.

Tools
3
Resources
0
Prompts
0

Pokémon MCP Server

A Model Context Protocol (MCP) server that provides Pokémon stats and images using the PokeAPI.

Features

  • get_pokemon_stats: Get Pokémon base stats (HP, Attack, Defense, Special Attack, Special Defense, Speed)
  • get_pokemon_images: Get Pokémon sprite images (front, back, shiny variants, and official artwork)
  • get_pokemon_info: Get complete Pokémon information including stats, images, and basic info
  • get_pokemon_cry: Get Pokémon cry sound file URL from PokeAPI/cries repository
  • play_pokemon_cry: Download and play Pokémon cry sound (platform-specific audio playback)

Installation

npm install
npm run build

Usage

Running the server

npm start

Available Tools

  1. get_pokemon_stats

    • Returns base stats for a Pokémon
    • Parameter: pokemon (string) - Pokémon name or ID number

  2. get_pokemon_images

    • Returns sprite URLs for a Pokémon
    • Parameter: pokemon (string) - Pokémon name or ID number

  3. get_pokemon_info

    • Returns complete Pokémon information
    • Parameter: pokemon (string) - Pokémon name or ID number

  4. get_pokemon_cry

    • Returns Pokémon cry sound file URL
    • Parameter: pokemon (string) - Pokémon name or ID number

  5. play_pokemon_cry

    • Downloads and plays Pokémon cry sound
    • Parameter: pokemon (string) - Pokémon name or ID number

Examples

// Get Pikachu's stats
{
  "pokemon": "pikachu"
}

// Get Charizard's images
{
  "pokemon": "charizard"
}

// Get complete info for Pokémon #25
{
  "pokemon": "25"
}

// Get Pikachu's cry sound URL
{
  "pokemon": "pikachu"
}

// Play Charizard's cry sound
{
  "pokemon": "charizard"
}

Response Format

Stats Response

{
  "name": "pikachu",
  "id": 25,
  "stats": {
    "hp": 35,
    "attack": 55,
    "defense": 40,
    "special-attack": 50,
    "special-defense": 50,
    "speed": 90
  },
  "types": ["electric"],
  "base_experience": 112
}

Images Response

{
  "name": "pikachu",
  "id": 25,
  "sprites": {
    "front_default": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/25.png",
    "front_shiny": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/shiny/25.png",
    "back_default": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/back/25.png",
    "back_shiny": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/back/shiny/25.png",
    "official_artwork": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/other/official-artwork/25.png"
  }
}

Cry Response

{
  "name": "pikachu",
  "id": 25,
  "cry_url": "https://raw.githubusercontent.com/PokeAPI/cries/main/cries/pokemon/latest/25.ogg",
  "format": "ogg",
  "source": "PokeAPI/cries repository"
}

Play Cry Response

{
  "name": "pikachu",
  "id": 25,
  "cry_url": "https://raw.githubusercontent.com/PokeAPI/cries/main/cries/pokemon/latest/25.ogg",
  "status": "再生完了",
  "platform": "win32",
  "file_saved_temporarily": "C:\\path\\to\\temp\\pikachu_cry.ogg"
}

API Source

This server uses the PokeAPI to fetch Pokémon data and PokeAPI/cries repository for sound files.