# mcpet伙伴
## 基本信息
- Slug: `shreyaskarnik-mcpet`
- Source: modelscope
- Publisher: @shreyaskarnik/mcpet
- Categories: games-and-gamification / knowledge-and-memory
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@shreyaskarnik/mcpet
## 简介
一种怀旧的虚拟宠物体验，适合人工智能时代，让你可以领养、养育并与自己的数字伙伴玩耍，该伙伴会根据你的照顾而进化。
## 安装提示

```bash
npm install
```

## MCP Server 详情

# MCPet

![MCPet](./image.webp)

[![smithery badge](https://smithery.ai/badge/@shreyaskarnik/mcpet)](https://smithery.ai/service/@shreyaskarnik/mcpet)

MCPet: 一个怀旧的虚拟宠物体验，专为AI时代设计！这个[模型上下文协议 (MCP)](https://modelcontextprotocol.io/) 服务器让你可以领养、照料并和你自己的数字伙伴一起玩耍，它们会根据你的照顾而成长。喂食、清洁、一起玩游戏，并看着它们从婴儿成长为成年。即使在你不在的时候，你的宠物的状态也会随着时间变化——就像经典的拓麻歌子玩具一样，但通过现代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](https://smithery.ai/service/@shreyaskarnik/mcpet)自动为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服务器通过stdio进行通信，调试可能会比较困难。我们推荐使用[MCP Inspector](https://github.com/modelcontextprotocol/inspector)：

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

Inspector将提供一个直接测试您的宠物互动的接口。

## 使用示例

可以向Claude提出如下问题：

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