MCPet

MCPet：为 AI 时代打造的怀旧虚拟宠物体验！这个 模型上下文协议 (MCP) 服务器让你领养、培育并与你自己的数字伙伴玩耍，它会根据你的照顾而进化。喂养它们、清洁它们、一起玩游戏，并看着它们从婴儿成长为成年。即使你不在身边，你的宠物的属性也会随着时间而变化——就像经典的拓麻歌子玩具一样，但由现代 AI 通过模型上下文协议提供支持。今天就领养你的数字朋友吧！

这是一个基于 TypeScript 的 MCP 服务器，它实现了一个虚拟宠物模拟系统。它通过提供宠物护理和互动工具来演示核心 MCP 概念。

特性

虚拟宠物类型

• 从四种宠物类型中选择：
  • 猫 - 有点喜怒无常但可爱
  • 狗 - 精力充沛，总是很高兴见到你
  • 龙 - 独特而火热的个性
  • 外星人 - 神秘而好奇

宠物生命周期

• 观看你的宠物经历四个阶段的进化：
  • 婴儿 - 弱小而脆弱
  • 儿童 - 成长和顽皮
  • 青少年 - 精力充沛，正在发展
  • 成年 - 完全长大且睿智

属性管理

• 通过管理五个关键属性来照顾你的宠物：
  • 饥饿 - 保持你的宠物吃饱
  • 快乐 - 和你的宠物玩耍以保持它们的快乐
  • 健康 - 受其他属性影响的整体健康状况
  • 能量 - 随着活动而消耗，随着休息而补充
  • 清洁度 - 定期洗澡可保持你的宠物清新

工具

• create_pet - 领养一只具有自定义名称和类型的新宠物
• check_pet - 查看你宠物当前的状况和属性
• feed_pet - 用不同的食物选项喂养你的宠物：
  • 零食 - 少量饥饿提升
  • 正餐 - 均衡营养
  • 盛宴 - 最大限度的喂养（但可能不健康）
• play_with_pet - 玩不同的游戏：
  • 球 - 轻度运动
  • 追逐 - 高能量乐趣
  • 拼图 - 精神刺激
• clean_pet - 给你的宠物洗澡以恢复清洁度
• put_to_bed - 让你的宠物睡觉以恢复能量

动画

• 每种宠物类型和活动的动态 ASCII 艺术动画
• 随机帧创造生动有趣的体验
• 特殊动画：
  • 吃不同的食物
  • 玩各种游戏
  • 洗澡
  • 睡觉
  • 生病
  • 还有更多！

开发

安装依赖项：

npm install

构建服务器：

npm run build

用于自动重建的开发：

npm run watch

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 MCPet：

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

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 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"
      }
    }
  }
}

注意：PET_DATA_DIR 环境变量指定宠物数据将存储的位置。确保这是一个具有写入权限的目录。

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector：

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

Inspector 将提供一个界面，用于直接测试你的宠物互动。

使用示例

向 Claude 提出如下问题：

• “你能创建一个名叫 Whiskers 的猫宠物吗？”
• “我的宠物怎么样了？”
• “你能喂我的宠物一顿正餐吗？”
• “我想和我的宠物玩追逐游戏”
• “我的宠物看起来很脏，你能给它洗个澡吗？”
• “我的宠物看起来很累，你能让它睡觉吗？”