MCPet

MCPet

MCPet：AI 时代的怀旧虚拟宠物体验！这个 Model Context Protocol (MCP) 服务让你领养、照料并陪伴专属于你的数字伙伴，它会根据你的关爱不断成长。给它喂食、清洁、一起玩游戏，看着它从宝宝成长为成年宠物。即使你不在，宠物的各项数据也会随时间变化——就像经典的拓麻歌子玩具，只不过由现代 AI 通过 Model Context Protocol 驱动。今天就来领养你的数字伙伴吧！

这是一个基于 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 的猫咪宠物吗？”
• “我的宠物怎么样了？”
• “你能给我的宠物喂一顿餐食吗？”
• “我想和我的宠物玩追逐游戏。”
• “我的宠物看起来脏了，能给它洗个澡吗？”
• “我的宠物好像累了，能让它上床睡觉吗？”