Pokémon Data

🚀 Poke-MCP

Poke-MCP is a service built on the Model Context Protocol (MCP) that provides Pokémon information through a unified interface. It connects to PokeAPI to fetch Pokémon data and supports any compatible clients (such as Claude desktop app, Continue, Cline, etc.) via MCP tools.

🚀 Quick Start

Poke-MCP offers a standardized way to interact with Pokémon data. It uses the Model Context Protocol to bridge the gap between AI applications and external data sources.

✨ Features

• Query detailed information of a specific Pokémon by name.
• Randomly retrieve Pokémon information.
• Find random Pokémon from a specific region (e.g., Kalos, Hoenn, Sinnoh, etc.).
• Filter random Pokémon by type (e.g., Fire, Water, Electric, etc.).
• Support natural language queries related to Pokémon.

🔧 Technical Details

How it Works

Poke-MCP leverages the Model Context Protocol to enable standardized interactions between AI applications and external data sources. The service workflow is as follows:

1. Connect to PokeAPI to obtain Pokémon data.
2. Expose multiple tools through the MCP interface.
3. Handle requests from MCP clients.
4. Return formatted Pokémon information.

MCP Tools

Poke-MCP provides the following tools:

• get-pokemon: Get detailed information of a specific Pokémon by name.
• random-pokemon: Randomly get information of a Pokémon.
• random-pokemon-from-region: Randomly get a Pokémon from a specific region.
• random-pokemon-by-type: Randomly get a Pokémon by type.
• pokemon-query: Answer natural language queries about Pokémon.

Architecture Design

The service is built using the following technologies:

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

📦 Installation

Quick Installation with Smithery

Automatically install Poke-MCP for the Claude desktop app via 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

Using in Claude Desktop App

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

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

5. Restart the Claude desktop app.
6. You should now see the Pokémon tools integrated into Claude.

Example Queries

After connecting to the MCP client, you can execute the following commands:

• "Tell me about Pikachu."
• "Give me a random Pokémon."
• "Show me a random Pokémon from the Kalos region."
• "What Pokémon are of the Water type?"

Project Structure

• src/index.ts: Main service implementation.
• src/types.ts: TypeScript type definition file.
• package.json: Project dependencies and script information.
• tsconfig.json: TypeScript configuration file.

Extending New Features

To add new tools or enhance existing features:

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

📄 License

This project is licensed under the MIT License.