返回 MCP 目录
public公开dns本地运行

mcpet

MCPet是一个基于AI的虚拟宠物模拟系统,通过Model Context Protocol协议提供数字宠物养成体验。

article

README

🚀 MCPet

MCPet 带来人工智能时代怀旧的虚拟宠物体验!它基于 模型上下文协议 (MCP),让你收养、培育并与数字伙伴互动,伙伴会根据你的照顾方式不断进化。你可以喂食、清洁、和它玩游戏,见证它从婴儿成长为成年。即便你离开,宠物的统计数据也会随时间变化,就像经典的 Tamagotchi 玩具,不过由现代人工智能技术和模型上下文协议驱动。快来收养你的数字伙伴吧!

这是一个基于 TypeScript 的 MCP 服务器,实现了虚拟宠物模拟系统,通过展示核心 MCP 概念,提供宠物照顾和互动的工具。

🚀 快速开始

要使用 MCPet,请按照以下步骤操作:

  1. 克隆仓库
    git clone [仓库链接]
    cd mpet
    
  2. 安装依赖项
    npm install
    
  3. 构建项目(可选):
    npm run build
    
  4. 运行服务器
    npm start
    

✨ 主要特性

虚拟宠物类型

  • 可在四种宠物类型中选择:
    • 猫咪——略显情绪化但可爱
    • 小狗——精力充沛且总是快乐地见到你
    • 龙——独特而充满热情的性格
    • 外星人——神秘且好奇

生命周期

  • 见证你的宠物通过四个阶段成长:
    • 幼儿——小而脆弱
    • 孩子——正在成长且爱玩
    • 少年——精力充沛并不断发展
    • 成年——完全长大且智慧

统计管理

  • 通过照顾你的宠物来管理五个关键统计数据:
    • 饥饿——确保你的宠物吃得饱
    • 幸福感——与你的宠物互动以保持它们的快乐
    • 健康状况——受其他统计影响的整体健康
    • 能量——因活动而消耗,休息时恢复
    • 清洁度——定期洗澡能保持清洁

工具

  • create_pet——收养一只新宠物并自定义其名字和类型
  • check_pet——查看你的宠物当前状态和统计数据
  • feed_pet——用不同食物喂食你的宠物:
    • 小吃——轻微的饥饿缓解
    • 餐食——均衡营养
    • 宴会——最大量的喂食(但可能不健康)
  • play_with_pet——与你的宠物一起玩不同的游戏:
    • 捉球——轻度锻炼
    • 追逐——高能量乐趣
    • 解谜——智力刺激
  • clean_pet——给你的宠物洗澡以恢复清洁度
  • put_to_bed——让你的宠物睡觉以恢复精力

动画

  • 每个宠物类型和活动都有动态 ASCII 文本动画
  • 随机帧生成生动而吸引人的体验
  • 特殊动画包括:
    • 吃不同食物时
    • 玩各种游戏时
    • 洗澡时
    • 睡觉时
    • 生病时
    • 以及其他更多情况!

📦 安装指南

安装依赖项

npm install

构建服务器

npm run build

带有自动重建的开发环境

npm run watch

📚 详细文档

如果遇到问题,请检查以下内容:

  • 确保所有依赖项已正确安装。
  • 查看控制台输出以获取错误信息。
  • 如需帮助,可以参考项目文档或在 GitHub Issues 中报告问题。

感谢您使用 MCPet!希望您能享受与您的虚拟宠物互动的乐趣。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端