MCP Pokeapi Server

🚀 mcp-pokeapi-server

This server combines POKEAPI with the MCP (Model Context Protocol) specification to provide a tool for retrieving Pokémon information.

🚀 Quick Start

This project offers a tool for retrieving Pokémon information from LLM applications or MCP clients using the MCP protocol (JSON - RPC 2.0 over stdio). It leverages POKEAPI (https://pokeapi.co/) and uses zod for schema validation.

✨ Features

• Utilizes the MCP protocol (JSON - RPC 2.0 over stdio) to provide a tool for retrieving Pokémon information from LLM applications or MCP clients.
• Integrates with POKEAPI (https://pokeapi.co/) to access Pokémon data.
• Employs zod for schema validation.

📦 Installation

npm install

📦 Build

npx tsc

📦 Development Startup (ts - node)

npx ts - node src/index.ts

💻 Usage Examples

Basic Usage

You can send JSON - RPC requests via standard input/output from an MCP client or an LLM application.

1. Get the list of tools (list_tools)

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "list_tools"
}

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "getPokemonInfo",
        "description": "Retrieve Pokémon information from POKEAPI using the Pokémon name or ID.",
        "input_schema": { ... },
        "output_schema": { ... }
      }
    ]
  }
}

2. Get Pokémon information (call_tool)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "call_tool",
  "params": {
    "name": "getPokemonInfo",
    "arguments": {
      "nameOrId": "pikachu"
    }
  }
}

Example response

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "json",
        "data": {
          "name": "pikachu",
          "id": 25,
          "height": 4,
          "weight": 60,
          "types": ["electric"]
        }
      }
    ]
  }
}

📦 Testing

npm test

📚 Documentation

References

• Official MCP Documentation
• Official POKEAPI Website
• Zenn: Introduction to MCP