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:

Se conecta a PokeAPI para obtener datos de Pokémon.
Expone varias herramientas a través de la interfaz MCP
Procesa solicitudes de clientes de MCP
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

Descargue e instale la aplicación Claude Desktop
Abrir la configuración de Claude Desktop
Vaya a la configuración del desarrollador y edite el archivo de configuración.
Agregue la siguiente configuración:

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

Reiniciar Claude Desktop
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:

Definir nuevas funciones auxiliares para obtener y formatear datos
Registrar nuevas herramientas utilizando el método server.tool()
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.