What is Pokemon Mcp Server

The Pokémon MCP Server is a Model Context Protocol server designed to fetch detailed information about Pokémon from the PokéAPI, enabling developers to access a wide range of Pokémon-related data easily.

Use cases

It can be used to obtain specific details about individual Pokémon, search for Pokémon with pagination, retrieve information about types, moves, and abilities, making it beneficial for game developers, research, and enthusiasts looking to harness Pokémon data.

How to use

To use the server, first clone the repository, install the dependencies, and build the project. Start the server and integrate it with compatible applications like Claude for Desktop by configuring the MCP server settings, or test it using the MCP Inspector tool.

Key features

Key features include tools for fetching Pokémon data by name or ID, retrieving type information and its damage relations, searching for Pokémon with pagination, and accessing details about moves and abilities, ensuring comprehensive data retrieval options.

Where to use

This server can be utilized in application development, educational projects, or gaming platforms that require robust Pokémon data integration, providing a foundation for various Pokémon-related applications.

Pokémon MCP Server

This is a Model Context Protocol (MCP) server that provides tools for fetching Pokémon data from the PokéAPI.

Features

The server provides the following tools:

• get-pokemon: Fetch detailed information about a specific Pokémon by name or ID
• get-type: Get information about a Pokémon type and its damage relations
• search-pokemon: Search for Pokémon with pagination support
• get-move: Get details about a specific Pokémon move
• get-ability: Get information about a Pokémon ability

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

Running the Server

npm start

Using with Claude for Desktop

To use this server with Claude for Desktop, add it to your Claude for Desktop 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 test the server using the MCP Inspector:

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

Example Tool Usage

Fetching a Pokémon

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"}

API Limitations

This server uses the public PokéAPI, which has rate limiting. Please be respectful of the API’s usage limits.

License

MIT