pokemon-sim

pragya2003sah/pokemon-sim

3.1

If you are the rightful owner of pokemon-sim 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.

This project is an implementation of a Model Context Protocol (MCP) server that provides access to Pokémon data and simulates battles between Pokémon.

Pokemon MCP server

This project is an implementaion of Model Context Protocol(MCP) server that exposes pokemon data and simulates a battle between two pokemon.

Prerequisites

Python, Claude Desktop or any other mcp client

Installation

Install uv(a fast python package manager)

for windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex

for macOS and Linux curl -LsSf https://astral.sh/uv/install.sh | sh

install dependecies uv pip install -r requirements.txt

Run the server uv run mcp install main.py

After the message shows successfully installed pokemonserver in claude app you can add the server to claude desktop and ask it to expose stats of pokemon and simulate battle between two of them.

Features

Pokemon data access

clients can access the data to retrieve and explore pokemon data.

Returns a full list of all Pokemon with their details. Returns detailed info for a specific Pokemon by its name. Filters and returns all Pokémon that match a given primary or secondary type.

Example

can you tell me the stats of onix? can you list pokemons with water type?

Battle Simulation

Simulates a 1v1 battle between two Pokémon based on input stats and moves. Determines the winner based on type effectiveness, move power, Turn order based on speed and status effect. The pokemon who looses HP faster is declared the looser.A battle log is also provided to better understand the fight.

Example

If tentacool and ponyta decide to battle it out who will will? can you give me the detail battle information of the fight?