🧩 Pokemon MCP Server Demo
This is a simple MCP (Model Context Protocol) server that connects to the PokéAPI and exposes tools that an LLM can use to fetch Pokémon data, list popular Pokémon, and build a tournament squad.
It uses the FastMCP library and httpx to fetch live Pokémon info via a standardized protocol that works seamlessly with LLMs and AI agents.
🚀 Features
- Get detailed info about any Pokémon
- Create a powerful tournament squad
- List popular Pokémon picks
📦 Requirements
- Python 3.8+
- Node.js (for some LLM hosts that require it)
httpxmcp(Model Context Protocol library)
⚙️ Installation
# Clone the repo
git clone https://github.com/your-username/pokemon-mcp-server
cd pokemon-mcp-server
# Create a virtual environment
python -m venv venv
.\venv\Scripts\Activate # On Windows
# source venv/bin/activate # On macOS/Linux
# Install dependencies
pip install httpx "mcp[cli]"
⚙️ Quick Start Using uv
If you prefer using uv, follow these steps:
# Create a new directory for our project
uv init pokemon
cd pokemon
# Create virtual environment and activate it
uv venv
.venv\Scripts\activate # On Windows
# source .venv/bin/activate # On macOS/Linux
# Install dependencies
uv add mcp[cli] httpx
# Create our server file
new-item pokemon.py # On PowerShell