Pokemon MCP Server

🚀 Pokémon MCP Server

This is a server based on the Model Context Protocol (MCP), offering tools to retrieve Pokémon data from PokéAPI.

🚀 Quick Start

This server based on the Model Context Protocol (MCP) provides a suite of tools to fetch Pokémon data from PokéAPI. It simplifies the process of accessing detailed Pokémon information.

✨ Features

The server offers the following tools:

• get-pokemon: Retrieve detailed information about a specific Pokémon by name or ID.
• get-type: Obtain information about Pokémon types and their damage relations.
• search-pokemon: Search for Pokémon with support for paginated browsing.
• get-move: Get details of a specific Pokémon move.
• get-ability: Retrieve information about Pokémon abilities.

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/pokemon-mcp-server.git
cd pokemon-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Running the Server

npm start

Using with Claude for Desktop

To use this server in Claude for Desktop, add it to your configuration file:

For macOS:

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/pokemon-mcp-server/build/pokemon-server.js"]
    }
  }
}

For Windows:

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["C:\\path\\to\\pokemon-mcp-server\\build\\pokemon-server.js"]
    }
  }
}

Testing with MCP Inspector

You can use the MCP Inspector to test the server:

npx @modelcontextprotocol/inspector node build/pokemon-server.js

Basic Usage

Getting Pokémon Information

Tool: get-pokemon
Parameters: {"nameOrId": "pikachu"}

Getting Type Information

Tool: get-type
Parameters: {"type": "electric"}

Searching for Pokémon

Tool: search-pokemon
Parameters: {"limit": 5, "offset": 0}

Getting Move Information

Tool: get-move
Parameters: {"nameOrId": "thunderbolt"}

Getting Ability Information

Tool: get-ability
Parameters: {"nameOrId": "static"}

📚 Documentation

API Limitations

This server uses the public PokéAPI, which has rate limits. Please respect these limits.

📄 License

MIT