Pokemon MCP Server

🚀 Pokémon MCP Server Demo

This is a simple MCP (Model Context Protocol) server that connects to PokéAPI and provides tools for LLMs to fetch Pokémon data, list popular Pokémon, and build tournament teams.

It uses the FastMCP library and httpx to scrape data from real-time Pokémon information and connects via a standard protocol that seamlessly collaborates with LLMs and AI agents.

✨ Features

• Retrieve detailed information about any Pokémon.
• Create powerful tournament teams.
• List Pokémon that are popular choices.

📦 Prerequisites

• Python 3.8+
• Node.js (for some LLM hosts that require it)
• httpx
• mcp (Model Context Protocol library)

📦 Installation

# Clone the repository
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  # For Windows systems
# source venv/bin/activate  # For macOS/Linux systems

# Install dependencies
pip install httpx "mcp[cli]"

💻 Quick Start with uv

If you prefer to use uv, follow these steps:

# Create a new project directory
uv init pokemon
cd pokemon

# Create a virtual environment and activate it
uv venv
.venv\Scripts\activate  # For Windows systems
# source .venv/bin/activate  # For macOS/Linux systems

# Install dependencies
uv add mcp[cli] httpx

# Create our server file
new-item pokemon.py  # In PowerShell