Tamagotchi MCP - README en Español

README_ESP.md

Tamagotchi MCP

Servidor MCP (stdio) que permite a un LLM cuidar una mascota virtual. La interfaz web es de solo lectura y muestra el estado en tiempo real.

Instalacion

npm install
npm run build

Uso

Servidor MCP -- agregar a la config de tu cliente MCP:

{
  "mcpServers": {
    "tamagotchi": {
      "command": "node",
      "args": ["/ruta/a/tamagotchi-mcp-2/dist/index.js"]
    }
  }
}

Interfaz web -- correr en otra terminal:

node dist/server.js
# → http://localhost:3333

Herramientas

Herramienta	Parametros	Efecto
check_status	--	Estado completo: stats, mood, edad, acciones recientes
feed_pet	food: fish, meat, salad, candy, premium_food	Restaura hambre/felicidad/salud
play_with_pet	activity: ball, laser, puzzle, walk	Sube felicidad, gasta energia
put_to_sleep	--	+40 energia (requiere energia < 60)
heal_pet	--	+30 salud (requiere salud < 70)
rename_pet	new_name: 1-30 caracteres	Cambia el nombre
change_species	species: cat, dog, rabbit, dragon, alien	Transforma la mascota, stats a 70
revive_pet	--	Revive mascota muerta, stats a 50

Decay de Stats

• Hambre: -1 cada 2 min
• Felicidad: -1 cada 3 min
• Energia: -1 cada 4 min
• Salud: -1 cada 5 min (solo si hambre < 20)

La mascota muere si hambre o salud llegan a 0.

Arquitectura

src/index.ts   → Servidor MCP (stdio), definicion de tools
src/pet.ts     → Logica del juego, tipos, decay, persistencia
src/server.ts  → Servidor HTTP para la interfaz web
data/pet.json  → Estado persistente de la mascota
web/index.html → UI pixel art (sprites en canvas, animaciones CSS, polling)

La interfaz web es solo lectura. Todo el control se realiza a traves del LLM via herramientas MCP.