Tamagotchi MCP Server

What is Tamagotchi MCP Server?

Tamagotchi MCP Server is a simple Model Context Protocol server that simulates a virtual pet (Tamagotchi) game. It allows you to raise a digital pet by issuing natural language commands through an MCP client like Claude Desktop.

How to use Tamagotchi MCP Server?

Set up a Python 3.11 virtual environment, install dependencies from requirements.txt, and start the FastAPI server with uvicorn tamagotchi:app --host 0.0.0.0 --port 8000. Then configure Claude Desktop to point to the server script. Once configured, you can interact with your virtual pet using commands such as “幫小雞取名字” (name the chick) or “餵小雞吃飯” (feed the chick).

Key features of Tamagotchi MCP Server

• Name your virtual pet chick.
• Check the pet’s current status.
• Shake the egg to hatch.
• Feed, play, and rest with the pet.
• Bathe, clean, and take the pet to the vet.
• Reset the game at any time.

Use cases of Tamagotchi MCP Server

• Learning how to build and deploy an MCP server.
• Demonstrating MCP integration with Claude Desktop.
• Prototyping a simple virtual pet game with AI interaction.
• Experimenting with stateful game logic inside MCP.

FAQ from Tamagotchi MCP Server

What does Tamagotchi MCP Server do?

It simulates a virtual pet you can raise by sending commands through an MCP client. Actions include naming, feeding, playing, and cleaning.

What are the prerequisites?

Python 3.11 and the uvicorn ASGI server are required.

How do I start the server?

Run uvicorn tamagotchi:app --host 0.0.0.0 --port 8000 after installing dependencies.

How can I interact with the virtual pet?

Use the listed basic actions such as “查看小雞狀況” (check status) or “跟小雞玩” (play with the chick) via Claude Desktop.

How do I reset the game?

Use the “重置遊戲” (reset game) command to start over.