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 :

Instalación manual

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:

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.