AdeetyaDubey5/Pokemon-MCP-Server

Pokémon MCP Server

An MCP (Model Context Protocol) Server that provides:

1. Pokémon Data Resource – exposes Pokémon stats, types, abilities, moves, and evolution information.
2. Battle Simulation Tool – allows AI models (or users) to simulate battles between any two Pokémon with mechanics like type effectiveness, move damage, turn order, and status effects.

This project bridges AI models with Pokémon knowledge, enabling both querying Pokémon data and running battle simulations.

⚡ Features

Pokémon Data Resource

• Provides comprehensive Pokémon data:
  • Base stats (HP, Attack, Defense, Special Attack, Special Defense, Speed)
  • Types (e.g., Fire, Water, Grass)
  • Abilities
  • Available moves & effects
  • Evolution information
• Accessible via MCP resource queries

Battle Simulation Tool

• Input: any two Pokémon with selected moves
• Core mechanics:
  • ✅ Type effectiveness multipliers (e.g., Water > Fire)
  • ✅ Damage calculation based on stats and move power
  • ✅ Turn order determined by Speed
  • ✅ Status effects: Paralysis, Burn, Poison
• Outputs:
  • Detailed turn-by-turn battle logs
  • Winner declaration
  • JSON result format for easy integration

🛠️ Installation

Clone this repository:

git clone https://github.com/AdeetyaDubey5/Pokemon-MCP-Server.git
cd Pokemon-MCP-Server bash

Install Dependencies:

pip install -r requirements.txt

Start the server:

uvicorn main:app --reload

📊 Example Queries

1. Query Pokémon Data

Request:

GET /pokemon/pikachu

Response:

{
  "name": "Pikachu",
  "types": ["Electric"],
  "stats": {
    "hp": 35,
    "attack": 55,
    "defense": 40,
    "special-attack": 50,
    "special-defense": 50,
    "speed": 90
  },
  "abilities": [
    {"name": "Static", "is_hidden": false},
    {"name": "Lightning Rod", "is_hidden": true}
  ],
  "moves": ["Thunderbolt", "Quick Attack", "Iron Tail"],
  "evolution_chain": ["Pichu", "Pikachu", "Raichu"]
}

2. Simulate a Battle

Request:

POST /battle/simulate
Content-Type: application/json

{
  "attacker": "Charmander",
  "defender": "Squirtle",
  "attacker_moves": ["seismic-toss","fury-swipes","mud-slap"],
  "defender_moves": ["Water Gun","bubble","rapid-spin"],
  "max_turns": 50,
  "random_seed": 42
}

Response:

{
  "winner": "squirtle",
  "turns": 2,
  "log": [
    "-- Turn 1 --",
    "charmander used seismic-toss (no direct damage in this sim)",
    "squirtle used bubble -> -69 (effectiveness x2.0)",
    "-- Turn 2 --",
    "charmander used seismic-toss (no direct damage in this sim)",
    "squirtle used bubble -> -49 (effectiveness x2.0)"
  ]
}