MCPet

MCPet: 一个怀旧的虚拟宠物体验，专为AI时代设计！这个模型上下文协议 (MCP) 服务器让你可以领养、照顾并和你自己的数字伴侣一起玩耍，它会根据你的照顾而进化。喂食、清洁、一起玩游戏，并看着它们从婴儿成长为成年。即使在你不在线的时候，你的宠物的状态也会随时间变化——就像经典的拓麻歌子玩具一样，但通过模型上下文协议由现代AI驱动。今天就领养你的数字朋友吧！

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

功能

虚拟宠物类型

• 从四种宠物类型中选择：
  • 猫 - 稍微有点情绪化但很可爱
  • 狗 - 充满活力且总是很高兴见到你
  • 龙 - 独特且火辣的性格
  • 外星人 - 神秘且好奇

宠物生命周期

• 观察你的宠物经历四个阶段：
  • 婴儿 - 小巧且脆弱
  • 儿童 - 成长中且爱玩
  • 青少年 - 充满活力且正在发展
  • 成年 - 完全长大且智慧

状态管理

• 通过管理五个关键状态来照顾你的宠物：
  • 饥饿 - 让你的宠物吃饱
  • 快乐 - 和你的宠物玩耍以保持其快乐
  • 健康 - 受其他状态影响的整体健康
  • 精力 - 活动消耗精力，休息恢复精力
  • 清洁 - 定期洗澡让宠物保持清新

工具

• create_pet - 用自定义的名字和类型领养一只新宠物
• check_pet - 查看你的宠物当前的状态和属性
• feed_pet - 用不同的食物选项喂养你的宠物：
  • 小吃 - 小幅度增加饥饿值
  • 正餐 - 平衡营养
  • 盛宴 - 最大限度地喂食（但可能不健康）
• play_with_pet - 玩不同的游戏：
  • 球 - 轻度运动
  • 追逐 - 高能量乐趣
  • 拼图 - 脑力刺激
• clean_pet - 给你的宠物洗澡以恢复清洁
• put_to_bed - 让你的宠物睡觉以恢复精力

动画

• 每种宠物类型和活动都有动态ASCII艺术动画
• 随机帧创建生动且引人入胜的体验
• 特殊动画包括：
  • 吃不同食物
  • 玩各种游戏
  • 洗澡
  • 睡觉
  • 生病
  • 等等！

开发

安装依赖：

bash
npm install

构建服务器：

bash
npm run build

开发时自动重建：

bash
npm run watch

安装

通过Smithery安装

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

bash
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

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：

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

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

使用示例

向Claude提问，例如：

• "你能创建一只名叫Whiskers的猫宠物吗？"
• "我的宠物怎么样了？"
• "你能给我的宠物喂一顿饭吗？"
• "我想和我的宠物玩追逐游戏"
• "我的宠物看起来脏了，能给它洗个澡吗？"- "我的宠物似乎累了，你能把它放到床上吗？"