简介

一种怀旧的虚拟宠物体验，适合人工智能时代，让你可以领养、养育并与自己的数字伙伴玩耍，该伙伴会根据你的照顾而进化。

简介

一种怀旧的虚拟宠物体验，适合人工智能时代，让你可以领养、养育并与自己的数字伙伴玩耍，该伙伴会根据你的照顾而进化。

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的猫宠物吗？"
• "我的宠物怎么样了？"
• "你能给我的宠物喂食一顿饭吗？"
• "我想和我的宠物玩追逐游戏"
• "我的宠物看起来很脏，能给它洗个澡吗？"
• "我的宠物似乎累了，能让它上床睡觉吗？"

服务配置

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

来源

• 来源：github
• 链接：https://github.com/shreyaskarnik/mcpet