Poke Api MCP Rb

🚀 Pokémon Information MCP Server

This project is a Pokémon information MCP server built on mcp_rb. It fetches Pokémon data from PokeAPI and provides a simple interface for Claude to interact with the Pokémon database.

🚀 Quick Start

This Pokémon information MCP server is built on mcp_rb. It fetches Pokémon data from PokeAPI and provides a simple interface for Claude to interact with the Pokémon database.

✨ Features

• Retrieve basic information about Pokémon (ID, name, height, weight, type).
• Obtain the URL of a Pokémon's sprite image.
• Randomly get information about a Pokémon.

📦 Installation

1. First, install the required gems:

bundle install

2. Start the MCP server:

ruby poke_api.rb

💻 Usage Examples

Claude Desktop Configuration

Add the following configuration to your Claude desktop configuration file (usually located at ~/.config/claude-desktop/config.json or ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "local": {
      "command": "ruby",
      "args": ["/path/to/your/poke_api.rb"],
      "env": {
        "RUBY_ENV": "development"
      },
      "disabled": false,
      "alwaysAllow": ["pokemon_info", "pokemon_sprite"]
    }
  }
}

⚠️ Important Note

Replace /path/to/your/poke_api.rb with the actual path to your poke_api.rb file.

Available Tools

1. pokemon_info

   • Retrieve basic information about a Pokémon.
   • Parameter: name_or_id (Pokémon name or ID).

2. pokemon_sprite

   • Obtain the URL of a Pokémon's sprite image.
   • Parameter: name_or_id (Pokémon name or ID).

Basic Usage

# Get information about Pikachu
pokemon_info("pikachu")

# Get the sprite image URL of Pikachu
pokemon_sprite("pikachu")

📚 Documentation

Dependencies

• Ruby
• mcp gem
• net/http
• json
• uri

📄 License

This project is licensed under the MIT License.