虚

虚拟宠物

在数字浪潮中重拾 90 年代电子宠物的温暖记忆，MCPet 以现代 AI 技术重构怀旧体验。这一基于 TypeScript 开发的 MCP 服务器，打造了全生命周期的虚拟宠物养成生态：从孵化初生宠物到陪伴其成长为成熟形态，每一次喂养、清洁、互动都将实时影响宠物的性格、状态与成长轨迹。

art-and-culture

1.9k 查看 · 2026-07-07 更新

简介

一、项目概述

MCPet 是一款基于 TypeScript 开发的 Model Context Protocol（MCP）服务器应用，旨在为用户带来 AI 时代的怀旧虚拟宠物体验。它复刻了经典 Tamagotchi 玩具的养成玩法，结合现代 AI 技术与模型上下文协议，用户可以收养、培养并与自己的数字伴侣互动，看着它们从婴儿成长为成人。即使离线，宠物的各项统计数据也会随时间自然变化，为用户提供真实且富有情感的虚拟宠物养成体验。

二、核心功能

全生命周期养成：支持宠物从婴儿期到成年期的完整成长过程，每次互动都会影响宠物的成长轨迹。丰富互动玩法：提供喂养、清洁、游戏等多样化互动方式，宠物会根据用户的照顾情况改变性格和状态。 AI 驱动特性：基于模型上下文协议（MCP），宠物具备一定的学习和反馈能力，互动越频繁，宠物表现越智能。离线动态更新：即使用户不在线，宠物的饥饿值、清洁度等状态也会实时变化，模拟真实宠物的生存逻辑。

三、技术架构

开发语言：TypeScript，提供强类型支持，提升代码的可维护性和稳定性。框架与库：采用 Node.js 作为运行环境，结合 Express 框架搭建服务器，使用 WebSocket 实现实时状态同步。数据存储：默认使用内存数据库存储宠物数据，支持扩展至 MongoDB 等持久化存储方案。协议支持：深度践行模型上下文协议（MCP），实现用户行为与宠物状态的动态关联。

四、安装与配置

4.1 环境要求 Node.js 版本：需 >= v14.0.0 npm 版本：>= v6.14.0

4.2 安装步骤克隆项目仓库： git clone https://github.com/shreyaskarnik/mcpet.git

进入项目目录： cd mcpet

安装依赖： npm install

4.3 配置说明环境变量配置：在项目根目录下创建.env文件，并配置以下环境变量：服务器端口号，默认为3000 PORT=3000 宠物数据存储目录，需为可写目录 PET_DATA_DIR=/path/to/writable/directory （可选）若使用MongoDB，配置数据库连接字符串 MONGODB_URI=mongodb://localhost:27017/mcpet

其他配置：可根据需求修改config目录下的配置文件，调整服务器参数和功能选项。

五、使用方法

5.1 启动服务 npm start

服务启动后，默认访问地址为http://localhost:3000。

5.2 用户操作指南领养宠物：访问服务页面，按照引导流程领养属于自己的虚拟宠物。日常互动：通过页面提供的喂养、清洁、游戏等功能按钮，与宠物进行互动，观察宠物状态变化。查看宠物信息：在宠物详情页，可查看宠物的健康值、快乐值、成长进度等详细信息。

六、API 文档

本项目提供了部分 RESTful API 用于与宠物服务进行交互，具体接口文档可在docs/api目录下查看，或通过在线文档工具生成。主要 API 包括：获取宠物列表：GET /api/pets 获取单个宠物详情：GET /api/pets/{petId} 喂养宠物：POST /api/pets/{petId}/feed 清洁宠物：POST /api/pets/{petId}/clean

七、贡献与反馈

贡献指南：欢迎开发者提交代码贡献，具体流程请参考CONTRIBUTING.md。问题反馈：若在使用过程中遇到问题或有改进建议，可通过 GitHub 的 Issue 板块提交反馈，或发送邮件至 [作者邮箱]。

八、许可证

服务配置

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

来源

来源：ModelScope
链接：https://github.com/shreyaskarnik/mcpet?tab=readme-ov-file