Poke-MCP

Descripción general

Poke-MCP es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona información de Pokémon mediante una interfaz estandarizada. Se conecta a PokeAPI para obtener datos de Pokémon y los expone mediante herramientas MCP compatibles con cualquier cliente compatible con MCP, como Claude Desktop App, Continue, Cline y otros.

Características

• Obtén información sobre Pokémon específicos por nombre

• Descubre Pokémon al azar

• Encuentra Pokémon aleatorios de regiones específicas (Kanto, Johto, Hoenn, etc.)

• Consigue Pokémon aleatorios de tipos específicos (Fuego, Agua, Eléctrico, etc.)

• Interfaz de consulta en lenguaje natural para información de Pokémon

Cómo funciona

Poke-MCP se basa en el Protocolo de Contexto de Modelo , que permite a las aplicaciones de IA acceder a herramientas y fuentes de datos externas de forma estandarizada. El servidor:

1. Se conecta a PokeAPI para obtener datos de Pokémon.

2. Expone varias herramientas a través de la interfaz MCP

3. Procesa solicitudes de clientes de MCP

4. Devuelve información formateada de Pokémon

Herramientas MCP

El servidor proporciona las siguientes herramientas:

• get-pokemon: obtén información detallada sobre un Pokémon específico por su nombre

• random-pokemon: Obtén información sobre un Pokémon aleatorio

• random-pokemon-from-region: obtén un Pokémon aleatorio de una región específica

• random-pokemon-by-type: Consigue un Pokémon aleatorio de un tipo específico

• pokemon-query: Responde consultas en lenguaje natural sobre Pokémon

Arquitectura

El servidor está construido utilizando:

• Mecanografiado

• SDK de TypeScript de MCP (@modelcontextprotocol/sdk)

• Zod para validación de entrada

• Transporte de E/S estándar para la comunicación MCP

Instalación

Instalación mediante herrería

Para instalar Pokémcp para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

# 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

Uso

Con la aplicación de escritorio Claude

1. Descargue e instale la aplicación Claude Desktop

2. Abrir la configuración de Claude Desktop

3. Vaya a la configuración del desarrollador y edite el archivo de configuración.

4. Agregue la siguiente configuración:

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

5. Reiniciar Claude Desktop

6. Ahora deberías ver las herramientas Pokémon disponibles en Claude

Consultas de ejemplo

Una vez conectado a un cliente MCP, puede hacer preguntas como:

• "Cuéntame sobre Pikachu"

• "Dame un Pokémon al azar"

• "Muéstrame un Pokémon al azar de Kanto"

• "¿Qué es un Pokémon de agua aleatorio?"

Estructura del proyecto

• src/index.ts: Implementación del servidor principal

• src/types.ts: Definiciones de tipos de TypeScript para datos de Pokémon

• package.json: Dependencias y scripts del proyecto

• tsconfig.json: configuración de TypeScript

Añadiendo nuevas funciones

Para agregar nuevas herramientas o mejorar las existentes:

1. Definir nuevas funciones auxiliares para obtener y formatear datos

2. Registrar nuevas herramientas utilizando el método server.tool()

3. Implementar la lógica de la herramienta para manejar solicitudes y devolver respuestas

Licencia

ISC

Expresiones de gratitud

• PokeAPI para proporcionar los datos de Pokémon

• Protocolo de contexto modelo para la interfaz estandarizada

Este proyecto demuestra cómo construir servidores MCP personalizados que puedan ampliar los asistentes de IA con conocimientos y capacidades específicos del dominio.