1. Conduid
  2. Developer Tools
  3. Yuns Desktop Pet
MCP server · Developer Tools

Yuns Desktop Pet

by · github.com/JianguSheng/yuns-desktop-pet

🐕 AI桌面宠物助手 - 多模型对话 + MCP工具调用 + 视觉分析 | Electron

Unclaimed MIT last commit 10 months ago devtools
InstallView source
71Good

Scored 3 days ago · breakdown

About Yuns Desktop Pet

Yuns Desktop Pet is an MCP server published by JianguSheng in the Developer Tools category: 🐕 AI桌面宠物助手 - 多模型对话 + MCP工具调用 + 视觉分析 | Electron.

The repository has 141 stars and 36 forks, with the last commit 10 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/JianguSheng/yuns-desktop-pet

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Yuns Desktop Pet

Powered by Claude · Grounded in docs

I know everything about Yuns Desktop Pet. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v2.2.0Yuns桌面助手 v2.2.0 · 24 Dec 2025✨ 新功能 新增 6 个 AI 提供商：Claude、智谱、月之暗面、零一万物、硅基流动、Groq 更新 Gemini 3 系列模型支持 新增网络代理配置功能（动态切换，无需重启） 自定义 API 支持手动输入任意模型 ID 🐛 修复 修复编辑配置时 API 地址被重置的问题 💄 优化 优化设置页面 UI 优化 Gemini 中转站稳定性
v2.1.0Yuns桌面助手 v2.1.0 · 20 Dec 2025🐕 Yuns桌面助手 v2.1.0 智能桌面宠物 - 多模型AI对话助手 ✨ 功能特性 🤖 多模型支持（DeepSeek/Gemini/OpenAI） 👁️ 视觉分析（截屏发送给AI） 🛠️ MCP 工具调用 🔄 Gemini API 中转站 📦 下载安装 1. 下载 `Yuns桌面助手-v2.1.0-win64.zip` 2. 解压到任意目录 3. 运行 `Yuns桌面助手.exe` ⚠️ 注意 首次使用需配置 API Key exe 必须和其他文件放在一起运行

README

🐕 Yuns桌面助手

✨ 功能特性

🤖 多模型AI对话（支持 10+ 提供商）

国际服务

  • DeepSeek - DeepSeek-V3 Chat、DeepSeek-R1 推理模型
  • Google Gemini - Gemini 3 Pro/Flash、Gemini 2.5 系列（最新）
  • OpenAI - GPT-4o、o1/o3 推理系列
  • Anthropic Claude - Claude Sonnet 4、Claude 3.5 系列
  • Groq - Llama 3.3 70B（免费高速推理）

国内服务

  • 智谱 GLM - GLM-4 Plus、GLM-4V 视觉模型
  • 月之暗面 Kimi - Moonshot v1 系列（128K 超长上下文）
  • 零一万物 Yi - Yi Lightning、Yi Large
  • 硅基流动 - Qwen2.5、DeepSeek-V3 托管版

其他

  • 自定义 API - 支持任何 OpenAI 兼容接口，可手动输入模型 ID

👁️ 视觉分析

  • 一键截屏并发送给AI分析
  • 支持多模态视觉理解
  • 自动隐藏窗口后截屏，确保截图干净

🛠️ MCP 工具调用

  • 支持 Model Context Protocol (MCP) 标准
  • 内置文件系统、终端命令、网络请求等预设
  • AI 可自主调用工具完成复杂任务
  • 支持自定义 MCP 服务器配置

🔄 Gemini API 中转站

  • 内置 Gemini API 代理服务器
  • 支持多 Key 轮询负载均衡
  • 自动从 API 配置同步 Gemini Keys
  • OpenAI 兼容格式，方便在其他应用中使用

🌐 网络代理配置

  • 支持 HTTP/HTTPS 代理
  • 动态切换，无需重启应用
  • 适用于所有 API 请求

🎨 界面特性

  • 🐕 可爱的桌面宠物形象
  • 🌓 支持明暗主题切换
  • 💬 流式输出，实时显示AI回复
  • 📝 友好的提示消息系统
  • 📄 对话导出为 Markdown 文件
  • 🖼️ 响应式设计，窗口大小自适应

🖼️ 界面预览

桌面宠物 对话界面 设置界面
可爱柴犬桌宠 多模型智能对话 丰富配置选项

🚀 快速开始

环境要求

  • Node.js 18+
  • npm 或 yarn

安装步骤

# 1. 克隆项目
git clone https://github.com/JianguSheng/yuns-desktop-pet.git
cd yuns-desktop-pet

# 2. 安装依赖
npm install

# 3. 启动应用
npm start

# 开发模式（带开发者工具）
npm run dev

构建可执行文件

# 构建 Windows 版本
npm run build

# 构建便携版
npm run build:portable

构建完成后，可执行文件位于 dist/win-unpacked/ 目录。

⚙️ 配置说明

API 配置

首次使用需要配置 AI 模型的 API：

  1. 双击桌面宠物打开对话窗口
  2. 点击右上角 ⚙️ 设置
  3. 在 API 配置 标签页添加或编辑配置
  4. 填写 API 地址和密钥
  5. 点击 测试连接 验证配置

支持的 API 提供商

提供商 默认 API 地址 推荐模型
DeepSeek https://api.deepseek.com/v1/chat/completions deepseek-chat, deepseek-reasoner
Google Gemini https://generativelanguage.googleapis.com/v1beta/models gemini-3-pro-preview, gemini-2.5-flash
OpenAI https://api.openai.com/v1/chat/completions gpt-4o, o1, o3-mini
Anthropic Claude https://api.anthropic.com/v1/messages claude-sonnet-4, claude-3-5-sonnet
Groq (免费) https://api.groq.com/openai/v1/chat/completions llama-3.3-70b-versatile
智谱 GLM https://open.bigmodel.cn/api/paas/v4/chat/completions glm-4-plus, glm-4v-plus
月之暗面 Kimi https://api.moonshot.cn/v1/chat/completions moonshot-v1-128k
零一万物 Yi https://api.lingyiwanwu.com/v1/chat/completions yi-lightning, yi-large
硅基流动 https://api.siliconflow.cn/v1/chat/completions Qwen/Qwen2.5-72B-Instruct
自定义 API 自行配置 支持手动输入任意模型 ID

网络代理配置

如果需要通过代理访问 API：

  1. 进入 设置 → 通用设置
  2. 找到 网络代理 区域
  3. 启用代理并填写代理地址和端口
  4. 点击 测试代理 验证连接
  5. 保存配置 后立即生效，无需重启

MCP 工具配置

  1. 进入 设置 → 🛠️ MCP 工具
  2. 开启 启用 MCP 工具调用
  3. 添加 MCP 服务器或使用预设：
    • 📁 文件系统 - 文件读写操作
    • 💻 终端命令 - 执行系统命令
    • 🌐 网络请求 - HTTP 请求
  4. 勾选 启用此服务器 并点击 连接

MCP 预设配置

// 文件系统
command: npx
args: -y @modelcontextprotocol/server-filesystem C:/

// 终端命令
command: npx
args: -y @anthropics/mcp-server-shell

// 网络请求
command: npx
args: -y @anthropics/mcp-server-fetch

Gemini 中转站配置

  1. 进入 设置 → API 中转站
  2. 开启中转站服务
  3. 默认端口：3001
  4. 访问地址：http://127.0.0.1:3001/v1/chat/completions
  5. 支持 OpenAI 兼容格式调用

自定义 API / 中转站配置

适用于使用第三方 API 中转站的用户：

  1. 选择提供商类型为 自定义 API
  2. 填写中转站提供的 API 地址
  3. 填写中转站提供的 API Key
  4. 从列表选择模型，或选择 手动输入模型 ID 输入任意模型

📁 项目结构

project/
├── main.js              # Electron 主进程
├── preload.js           # 预加载脚本
├── config.js            # 应用配置（模型、窗口等）
├── store.js             # 数据持久化
├── api-service.js       # AI API 调用服务
├── mcp-client.js        # MCP 客户端管理
├── proxy-server.js      # Gemini API 中转站
├── proxy-key-manager.js # API Key 管理
├── renderer/            # 渲染进程
│   ├── pet.html         # 桌宠窗口
│   ├── chat.html/js/css # 对话窗口
│   ├── settings.html/js/css # 设置窗口
│   └── friendly-messages.js # 友好提示
├── assets/              # 资源文件
│   ├── shiba.jpg        # 桌宠图片
│   └── icon.png         # 应用图标
└── dist/                # 构建输出

🔧 高级功能

对话保存

对话可以导出为 Markdown 文件：

  • 点击对话界面的 💾 保存 按钮
  • 默认保存路径可在 config.js 中配置

窗口置顶

在 设置 → 通用设置 中可开启窗口置顶功能。

宠物大小调节

在 设置 → 外观设置 中可调节宠物大小：

  • 小：180x180
  • 中：230x230（默认）
  • 大：280x280

自定义主题

支持明暗主题切换，在 外观设置 中选择。

🛠️ 开发说明

开发模式

npm run dev

开发模式会自动打开开发者工具，方便调试。

菜单控制

# 隐藏菜单
npm run menu:hide

# 最小菜单
npm run menu:minimal

# 自定义菜单
npm run menu:custom

依赖说明

依赖 用途
electron 桌面应用框架
axios HTTP 请求
electron-store 数据持久化
@modelcontextprotocol/sdk MCP 协议支持
express 中转站服务器
electron-builder 应用打包
https-proxy-agent 网络代理支持

📋 更新日志

v2.2.0 (2025-12)

  • ✨ 新增 6 个 AI 提供商：Claude、智谱、月之暗面、零一万物、硅基流动、Groq
  • ✨ 更新 Gemini 3 系列模型支持
  • ✨ 新增网络代理配置功能（动态切换，无需重启）
  • ✨ 自定义 API 支持手动输入任意模型 ID
  • 🐛 修复编辑配置时 API 地址被重置的问题
  • 💄 优化设置页面 UI

v2.1.0 (2024-12)

  • ✨ 新增 MCP 工具调用功能
  • ✨ 新增 Gemini API 中转站
  • 🐛 修复多项已知问题
  • 💄 优化用户界面

v2.0.0

  • ✨ 多卡片配置系统
  • ✨ 多模型支持
  • ✨ 视觉分析功能
  • ✨ 流式输出

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📞 联系方式

📄 开源协议

本项目基于 MIT License 开源。

README fetched from the repository 4 days ago. The original is authoritative.

Questions

About Yuns Desktop Pet

How do I install Yuns Desktop Pet?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Yuns Desktop Pet safe to use with an AI agent?

Its trust score is 71 out of 100 (good). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Yuns Desktop Pet still maintained?

The last commit was 10 months ago and 1 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.