Pokemcp

🚀 Poke-MCP

Poke-MCP is a server based on the Model Context Protocol (MCP), providing Pokémon information through standardized interfaces. It connects to PokeAPI to retrieve Pokémon data and offers information to any compatible clients (such as Claude Desktop App, Continue, Cline, etc.) via MCP tools.

🚀 Quick Start

Poke-MCP is a powerful server that simplifies access to Pokémon information. It connects to PokeAPI to retrieve data and provides it to compatible clients through MCP tools.

✨ Features

• Retrieve detailed information about a specific Pokémon by name.
• Discover a random Pokémon.
• Find a random Pokémon from a specific region (Kanto, Johto, Hoenn, etc.).
• Get a random Pokémon of a specific type (Fire, Water, Electric, etc.).
• Support natural language query interfaces for obtaining Pokémon information.

🔧 Technical Details

How It Works

Poke-MCP is built using the Model Context Protocol, enabling AI applications to access external tools and data sources in a standardized manner. The server:

1. Connects to PokeAPI to fetch Pokémon data.
2. Provides multiple tools through the MCP interface.
3. Handles requests from MCP clients.
4. Returns formatted Pokémon information.

MCP Tools

The server offers the following tools:

• get-pokemon: Retrieve detailed information about a specific Pokémon by name.
• random-pokemon: Get information about a random Pokémon.
• random-pokemon-from-region: Get a random Pokémon from a specified region.
• random-pokemon-by-type: Get a random Pokémon based on its type.
• pokemon-query: Answer natural language queries about Pokémon.

Architecture

The server is built using the following technologies:

• TypeScript
• MCP TypeScript SDK (@modelcontextprotocol/sdk)
• Zod for input validation
• Standard I/O transport for MCP communication

📦 Installation

Install via Smithery

Automatically install Pokémcp for Claude Desktop through Smithery:

npx -y @smithery/cli install @NaveenBandarage/poke-mcp --client claude

Manual Installation

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

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Use with Claude Desktop App

1. Download and install Claude Desktop App.
2. Open Claude Desktop settings.
3. Go to developer settings and edit the configuration file.
4. Add the following configuration:

{
  "mcpServers": {
    "pokedex": {
      "command": "path/to/poke-mcp/build/index.js"
    }
  }
}

5. Restart Claude Desktop.
6. You should now see the Pokémon tools in Claude.

Example Queries

After connecting to the MCP client, you can ask the following questions:

• "Tell me about Pikachu."
• "Give me a random Pokémon."
• "Show me a random Pokémon from Kanto."
• "What's a random Water-type Pokémon?"

Project Structure

• src/index.ts: Main server implementation.
• src/types.ts: TypeScript data type definitions.
• package.json: Project dependencies and scripts.
• tsconfig.json: TypeScript configuration.

Adding New Features

To add new tools or enhance existing functionality:

1. Define new helper functions to fetch and format data.
2. Register new tools using the server.tool() method.
3. Implement tool logic to handle requests and return responses.