MCPet

MCPet: ¡Una experiencia nostálgica de mascota virtual para la era de la IA! Este servidor MCP te permite adoptar, cuidar y jugar con tu propio compañero digital, que evoluciona según tus cuidados. Aliméntalo, báñalo, jueguen juntos y obsérvalo crecer desde bebé hasta adulto. Las características de tu mascota cambian con el tiempo, incluso cuando no estás, igual que los clásicos juguetes Tamagotchi, pero con la tecnología de IA moderna a través del Protocolo de Contexto de Modelo. ¡Adopta a tu amigo digital hoy mismo!

Este es un servidor MCP basado en TypeScript que implementa un sistema de simulación de mascotas virtuales. Demuestra los conceptos básicos de MCP al proporcionar herramientas para el cuidado y la interacción con las mascotas.

Características

Tipos de mascotas virtuales

• Elija entre cuatro tipos de mascotas:

  • Gato - Un poco temperamental pero adorable.

  • Perro - Enérgico y siempre feliz de verte.

  • Dragón - Personalidad única y ardiente.

  • Extraterrestre - Misterioso y curioso

Ciclo de vida de las mascotas

• Observa cómo tu mascota evoluciona a través de cuatro etapas:

  • Bebé - Pequeño y vulnerable

  • Niño - Creciendo y juguetón

  • Adolescente - Enérgico y en desarrollo

  • Adulto: Completamente desarrollado y sabio.

Gestión de estadísticas

• Cuida a tu mascota gestionando cinco estadísticas clave:

  • Hambre - Mantenga a su mascota bien alimentada

  • Felicidad - Juega con tu mascota para mantenerla feliz

  • Salud: el bienestar general se ve afectado por otras estadísticas

  • Energía: se agota con la actividad y se repone con el descanso.

  • Limpieza: Los baños regulares mantienen a tu mascota fresca.

Herramientas

• create_pet - Adopta una nueva mascota con un nombre y tipo personalizados

• check_pet - Ver el estado actual y las estadísticas de tu mascota

• feed_pet - Alimenta a tu mascota con diferentes opciones de comida:

  • Snack - Pequeño estímulo para el hambre

  • Comida - Nutrición equilibrada

  • Fiesta - Alimentación máxima (aunque puede ser poco saludable)

• play_with_pet - Juega diferentes juegos:

  • Pelota - Ejercicio ligero

  • Chase - Diversión de alta energía

  • Rompecabezas - Estimulación mental

• clean_pet - Dale un baño a tu mascota para restaurar su limpieza

• put_to_bed - Deja que tu mascota duerma para recuperar energía

Animaciones

• Animaciones de arte ASCII dinámicas para cada tipo de mascota y actividad.

• Los marcos aleatorios crean una experiencia animada y atractiva.

• Animaciones especiales para:

  • Comer diferentes alimentos

  • Jugando varios juegos

  • Baños

  • Durmiendo

  • Estar enfermo

  • ¡Y más!

Related MCP server: buddy-mcp

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Instalación mediante herrería

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

npx -y @smithery/cli install @shreyaskarnik/mcpet --client claude

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcpet": {
      "command": "node",
      "args": ["/path/to/mcpet/build/index.js"],
      "env": {
        "PET_DATA_DIR": "/path/to/writable/directory"
      }
    }
  }
}

Nota: La variable de entorno PET_DATA_DIR especifica dónde se almacenarán los datos de la mascota. Asegúrese de que sea un directorio con permisos de escritura.

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP :

npx @modelcontextprotocol/inspector node /path/to/mcpet/build/index.js

El Inspector proporcionará una interfaz para probar directamente las interacciones de su mascota.

Ejemplos de uso

Pregúntale a Claude preguntas como:

• "¿Puedes crear una mascota gato llamada Whiskers?"

• ¿Cómo está mi mascota?

• "¿Puedes alimentar a mi mascota con una comida?"

• "Me gustaría jugar a la persecución con mi mascota"

• "Mi mascota se ve sucia ¿puedes bañarla?"

• "Mi mascota parece cansada, ¿puedes ponerla a dormir?"