# NyaDeskPet

> A desktop pet application based on Live2D and AI Agent

- **Type:** MCP server
- **Install:** `agentstack add mcp-gameswu-nyadeskpet`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gameswu](https://agentstack.voostack.com/s/gameswu)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [gameswu](https://github.com/gameswu)
- **Source:** https://github.com/gameswu/NyaDeskPet

## Install

```sh
agentstack add mcp-gameswu-nyadeskpet
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# NyaDeskPet

  
  基于 Live2D + AI Agent 的跨平台桌面宠物应用

---

完全开源的模块化桌宠框架，支持 Live2D 交互、内置 AI Agent。开箱即用，亦可高度定制。欢迎贡献插件、模型和功能！

> 移动端移植项目 [NyaDeskPetAPP](https://github.com/gameswu/NyaDeskPetAPP) 同步开发中！

## 特性

### 🎭 AI 驱动 Live2D 模型

  
    您的浏览器不支持视频标签。
  

- 透明无边框窗口，桌宠自然融入桌面
- AI 驱动的表情和动作，丰富生动的交互体验
- 触碰反应系统，按部位启用/禁用触碰交互
- TTS 驱动口型同步 & 流式音频播放

其他demo

  

### 🤖 内置 AI Agent

  
    
      支持多个主流模型供应商
      支持函数工具与MCP管理
      插件化架构
      支持自定义指令管理
    
    
      
      
      
      
    
  

### 🧩 插件体系

  
    
      完整的插件管理
      插件工作鉴权
    
    
      
      
    
  

上述演示工作的结果

  
  

## 文档

| 文档 | 说明 |
|------|------|
| [使用指南](docs/USAGE.md) | 安装、配置、运行使用指南 |
| [API 规范](docs/API.md) | WebSocket 消息协议 |
| [开发指南](docs/DEVELOPMENT.md) | 架构设计、核心模块 |
| [前端插件开发](docs/PLUGINS.md) | 前端插件 WebSocket 协议与开发流程 |
| [Agent 插件开发](docs/AGENT_PLUGINS.md) | Agent 插件基类、工具注册、Handler 插件 |
| [更新日志](docs/CHANGELOG.md) | 版本更新记录 |

## 快速开始

```bash
# 安装依赖
npm install

# 编译 TypeScript
npm run compile

# 开发启动
npm run dev:mac
npm run dev:linux
npm run dev:win

# 打包
npm run build:mac
npm run build:linux
npm run build:win
```

## 架构

### 分离式架构

前端与后端 Agent 通过 WebSocket 完全解耦。前端仅负责展示与交互，后端独立运行 Agent 服务器，任何 WebSocket 客户端均可接入。

  

### 内置 Agent 架构

内置 Agent 核心采用 Pipeline 架动设计，消息处理分为多个阶段（思考、工具调用、回复等），每个阶段可注册多个 Handler 插件，灵活定制 Agent 行为。

  

## 支持

如果喜欢这个项目，欢迎点个 Star ⭐！如有任何问题或建议，请提交 Issue 或 Pull Request。

或者💗[赞助我](https://afdian.com/a/gameswu)💗

## 许可证

[MIT License](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gameswu](https://github.com/gameswu)
- **Source:** [gameswu/NyaDeskPet](https://github.com/gameswu/NyaDeskPet)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-gameswu-nyadeskpet
- Seller: https://agentstack.voostack.com/s/gameswu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.