Pokemon MCP Server

# Pokemon MCP Server An MCP (Model Context Protocol) server built with FastMCP that provides Pokemon information including height, weight, and types. ## Features - Get Pokemon information by name or ID - Get random Pokemon by type - Compare two Pokemon side-by-side (Prompt) - No API keys required (uses free PokeAPI) - Provides height, weight, types, and base stats for any Pokemon ## Installation ### Option 1: Local Installation 1. Install dependencies: ```bash pip install -r requirements.txt ``` ### Option 2: Docker Build and run using Docker: ```bash # Build the Docker image docker build -t pokemon-mcp-server . # Run the container docker run -it pokemon-mcp-server ``` ## Usage ### Local Run the MCP server: ```bash python pokemon_server.py ``` ### Docker The Docker container runs the server automatically when started. The server communicates via stdin/stdout as per MCP protocol. ## API ### `get_pokemon(pokemon_name: str)` Get Pokemon information for a specified Pokemon by name or ID. **Parameters:** - `pokemon_name` (str): The name or ID of the Pokemon to look up (case-insensitive) **Returns:** - Formatted string with Pokemon information including: - Pokemon ID - Height (in meters and centimeters) - Weight (in kilograms) - Types **Example:** ``` get_pokemon("pikachu") get_pokemon("charizard") get_pokemon("25") # Can also use ID ``` ### `get_random_pokemons_by_type(type_name: str, n: int = 5)` Get n random Pokemon of a specified type. **Parameters:** - `type_name` (str): The type name (e.g., "fire", "water", "grass", "electric", etc.) - `n` (int): Number of random Pokemon to return (default: 5) **Returns:** - JSON string containing a list of Pokemon names of the specified type **Example:** ``` get_random_pokemons_by_type("fire", 10) get_random_pokemons_by_type("water") ``` ## Prompts ### `compare_pokemon(pokemon1_name: str, pokemon2_name: str)` Compare two Pokemon based on their stats, types, and characteristics. **Parameters:** - `pokemon1_name` (str): The name or ID of the first Pokemon - `pokemon2_name` (str): The name or ID of the second Pokemon **Returns:** - Formatted comparison string including: - Basic information (ID, height, weight, types) for both Pokemon - Base stats comparison (HP, Attack, Defense, Special Attack, Special Defense, Speed) - Total base stats comparison - Summary analysis **Example:** ``` compare_pokemon("pikachu", "charizard") compare_pokemon("25", "6") # Can also use IDs ``` ## How It Works 1. The server queries the PokeAPI endpoint: `https://pokeapi.co/api/v2/pokemon/{name}/` 2. Extracts height, weight, and types from the response 3. Converts height from decimeters to meters/centimeters and weight from hectograms to kilograms 4. Formats and returns the Pokemon information to the client ## Dependencies - `fastmcp`: FastMCP framework for building MCP servers - `requests`: HTTP library for making API requests ## API Reference The server uses the [PokeAPI](https://pokeapi.co/) which is free and doesn't require authentication.