MCPet

MCPet：一款怀旧的虚拟宠物体验，适用于人工智能时代！这款基于模型上下文协议（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自动安装MCPet到Claude Desktop：

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服务器通过标准输入输出进行通信，调试可能会比较困难。我们推荐使用MCP Inspector：

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

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

使用示例

向Claude提问如下问题：

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