hope-agent MCP工具 是 AI Skill Hub 本期精选AI工具之一。综合评分 8.2 分,整体质量较高。我们强烈推荐将其纳入你的 AI 工具库,帮助提升工作效率。
基于MCP协议的开源跨设备AI桌面助手,支持多端无缝交接、个性化学习和云端服务化部署。适合需要智能助手、开发者和AI爱好者,提供高度定制化的AI交互体验。
hope-agent MCP工具 是一款基于 Rust 开发的开源工具,专注于 MCP协议、跨端交接、桌面助手 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。
基于MCP协议的开源跨设备AI桌面助手,支持多端无缝交接、个性化学习和云端服务化部署。适合需要智能助手、开发者和AI爱好者,提供高度定制化的AI交互体验。
hope-agent MCP工具 是一款基于 Rust 开发的开源工具,专注于 MCP协议、跨端交接、桌面助手 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。
# 方式一:cargo install(推荐) cargo install hope-agent # 方式二:从源码编译 git clone https://github.com/shiwenwen/hope-agent cd hope-agent cargo build --release # 二进制在 ./target/release/hope-agent
# 查看帮助 hope-agent --help # 基本运行 hope-agent [options] <input> # 详细使用说明请查阅文档 # https://github.com/shiwenwen/hope-agent
# hope-agent 配置说明 # 查看配置选项 hope-agent --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量(覆盖配置文件) export HOPE_AGENT_CONFIG="/path/to/config.yml"
<p align="center"> <img src="assets/alpha-logo.png" alt="Hope Agent" width="200"> </p>
<p align="center"> <strong>跨端交接、越用越懂你的桌面 AI 助手,也能服务化常驻、跑在云上</strong><br/> 会记忆 · 能成长 · 深度融合 · 在你所有的聊天里随叫随到 </p>
<p align="center"> <a href="https://github.com/shiwenwen/hope-agent/actions/workflows/rust.yml"><img src="https://img.shields.io/github/actions/workflow/status/shiwenwen/hope-agent/rust.yml?branch=main&style=flat-square&logo=githubactions&logoColor=white&label=CI" alt="CI status"></a> <a href="https://github.com/shiwenwen/hope-agent/releases"><img src="https://img.shields.io/badge/macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"></a> <a href="https://github.com/shiwenwen/hope-agent/releases"><img src="https://img.shields.io/badge/Linux-experimental-FFA500?style=flat-square&logo=linux&logoColor=black" alt="Linux (experimental)"></a> <a href="https://github.com/shiwenwen/hope-agent/releases"><img src="https://img.shields.io/badge/Windows-experimental-FFA500?style=flat-square&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0wIDMuNDQ5TDkuNzUgMi4xdjkuNDUxSDBtMTAuOTQ5LTkuNjAyTDI0IDB2MTEuNEgxMC45NDlNMCAxMi42aDkuNzV2OS40NTFMMCAyMC42OTlNMTAuOTQ5IDEyLjZIMjRWMjRsLTEyLjktMS44MDEiLz48L3N2Zz4=" alt="Windows (experimental)"></a> <a href="#运行模式"><img src="https://img.shields.io/badge/Web%20GUI-browser-4F46E5?style=flat-square&logo=googlechrome&logoColor=white" alt="Web GUI"></a> <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/Rust-edition%202021-dea584?style=flat-square&logo=rust&logoColor=white" alt="Rust"></a> <a href="https://tauri.app/"><img src="https://img.shields.io/badge/Tauri-2-24C8DB?style=flat-square&logo=tauri&logoColor=white" alt="Tauri"></a> <a href="https://react.dev/"><img src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=black" alt="React"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="License: MIT"></a> </p>
<p align="center"> <strong>简体中文</strong> · <a href="./README.en.md">English</a> </p>
---
Hope Agent 想让 AI 助手真正打开就能用,并且长期稳定地陪你工作:一个原生安装包,内置主流模型 Provider 配置模板;填完 API Key 就能开聊,不必先装运行时、学命令行,也不用维护一堆复杂配置。桌面端是最顺手的入口,我们把 GUI、性能、交互细节和系统深度融合放在最前面;在你授权后,它还能观察并控制本机电脑(暂时仅 macOS)。同时,Hope Agent 也可以作为 HTTP/WS 服务常驻 NAS、自家服务器或云主机,接入 IM 渠道、对接 IDE(ACP),让同一份会话在桌面、浏览器和聊天之间随手交接。随着日常使用,它会持续积累跨会话记忆,在空闲时整理重要内容,把做过的事沉淀成可复用技能。目标很简单:降低使用和维护成本,让日常场景顺手,让长期运行可靠。
📦 各平台完整安装包列表:Releases
brew tap shiwenwen/hope-agent
brew install --cask hope-agent
已经手动装过Hope Agent.app?在brew install后面加--adopt(接管同版本现有应用,不重新下载)或--force(强制重下覆盖)。
到 Releases 下载 Hope.Agent_*.dmg,拖到「应用程序」即可。
若启动时提示"已损坏"或"无法验证开发者",请在终端执行:> sudo xattr -cr /Applications/Hope\ Agent.app > sudo codesign --force --deep --sign - /Applications/Hope\ Agent.app >
Apple Silicon 与 Intel Mac 均提供原生构建(arm64 / x64 DMG),Homebrew 与手动下载都会按你的硬件自动选对版本。
open -a "Hope Agent" / hope-agenthope-agent server starthope-agent acpscoop bucket add hope-agent https://github.com/shiwenwen/scoop-hope-agent
scoop install hope-agent
到 Releases 下载 Hope.Agent_*-setup.exe 双击安装。Windows 端尚未完成充分测试,欢迎反馈问题。
若启动时提示"由于找不到 MSVCP140_1.dll,无法继续执行代码"或类似缺失VCRUNTIME140.dll/MSVCP140.dll,请安装 Microsoft Visual C++ 2015–2022 运行库(x64)后重启应用。
当前仅 x64。
hope-agenthope-agent server start(PowerShell / cmd)hope-agent acpyay -S hope-agent-bin # 或 paru / 任意 AUR helper
预编译二进制版(沿用 GitHub Release 的 .deb),不从源码编译。
curl -fsSL https://shiwenwen.github.io/hope-agent-linux-repo/pubkey.gpg | \
sudo gpg --dearmor -o /usr/share/keyrings/hope-agent.gpg
echo "deb [signed-by=/usr/share/keyrings/hope-agent.gpg] https://shiwenwen.github.io/hope-agent-linux-repo/apt stable main" | \
sudo tee /etc/apt/sources.list.d/hope-agent.list
sudo apt update
sudo apt install hope-agent
sudo curl -fsSL https://shiwenwen.github.io/hope-agent-linux-repo/rpm/hope-agent.repo \
-o /etc/yum.repos.d/hope-agent.repo
sudo dnf install hope-agent # 或 sudo yum install hope-agent
历史命令sudo dnf config-manager --add-repo …在 dnf5(Fedora 41+)已经废弃,用上面的curl写法对 dnf4 / dnf5 / yum / zypper 都兼容。
openSUSE 用户:
sudo zypper addrepo https://shiwenwen.github.io/hope-agent-linux-repo/rpm/hope-agent.repo
sudo zypper install hope-agent
到 Releases 下载(包名含架构后缀,按你的机器选 _amd64 / _arm64 或 .x86_64 / .aarch64):
Hope.Agent_*.AppImage —— chmod +x 后直接运行Hope.Agent_*.deb —— sudo dpkg -i Hope.Agent_*.debHope.Agent_*.rpm —— sudo rpm -i Hope.Agent_*.rpm提供 amd64 (x86_64) 与 arm64 (aarch64) 两种原生构建,覆盖普通 PC、树莓派 4/5、Apple Silicon 跑 Asahi Linux、Graviton / Ampere 云主机。apt 与 dnf 都会按 dpkg --print-architecture / $basearch 自动选对版本。
hope-agenthope-agent server starthope-agent acp把 Hope Agent 跑在家用 NAS / VPS / homelab 上、用浏览器访问 Web GUI 的场景:
docker run -d \
--name hope-agent \
-p 127.0.0.1:8420:8420 \
-v hope-data:/data \
ghcr.io/shiwenwen/hope-agent:latest
容器跑起来后浏览器打开 <http://127.0.0.1:8420>,按 Onboarding 向导配 Provider API Key。镜像覆盖 linux/amd64 + linux/arm64(含 Apple Silicon / 树莓派),随每次 Release Tag 自动构建。
要用 docker compose / 配合 Ollama 本地 LLM / 暴露到 LAN / 反向代理与 TLS / 升级流程,见 docs/deployment/docker.md。
| 🖥️ 桌面原生 GUI | macOS / Linux / Windows 三端原生应用,下载即用。12 种界面语言(简/繁中、英、日、韩、西、葡、俄、阿、土、越、马),深色主题与精心调校的字体排版。 |
| 🧙 傻瓜式 Provider 配置 | 44 个内置 Provider 模板,覆盖 335 个预设模型。Anthropic / OpenAI / Gemini / Codex / GitHub Copilot / OpenRouter / DeepSeek / Kimi / Qwen / 豆包 / GLM / MiniMax / xAI / Mistral / Cerebras / DeepInfra / Novita / 腾讯混元 / Ollama 一站式覆盖;同一 Provider 支持多 API Key 自动轮换,遇到限流或额度用尽无缝切换下一把钥匙。 |
| 🦙 本地小模型一键安装 | 不用账号、不用 API Key、不用终端——设置 → 模型页面按硬件挑一个能跑得动的 Qwen3.6 / Gemma 4 尺寸,一键完成 Ollama 安装、模型下载、Provider 注册与切换。同一流程也覆盖本地 Embedding 模型。 |
| 💬 12 个 IM 渠道一站接入 | Telegram、Discord、Slack、飞书、Google Chat、LINE、QQ Bot、Signal、iMessage、IRC、WeChat、WhatsApp。图片 / 语音 / 文件入站自动转多模态上下文;工具审批直接在聊天窗按按钮决定;每个群聊 / 账号可绑定独立 Agent 和权限策略。 |
| 🤝 对话随手交接,跨端不掉线 | 同一份会话能在桌面、浏览器、IM 之间**随手交接**——出门前在电脑上聊到一半,地铁里掏出手机用 Telegram 接着说,回家打开桌面应用它已经把外面 IM 期间的聊天捋好了。同一份记忆 / 工具状态 / Plan / 工作目录跟着走,另一端不用重新介绍上下文。/handover 把当前桌面会话推到指定 IM 聊天,/session <id> 在 IM 端反向接管;桌面正在跑的对话还会**流式镜像到 IM**,模型边写边在 Telegram / 飞书 / Slack 里打字。 |
| 🌐 独立服务 · 浏览器即客户端 | 不止是桌面应用——可以完全脱离 GUI 单独作为服务运行。一条命令 hope-agent server start 就能起一个 HTTP/WS 守护进程,server install 注册成 launchd / systemd 开机自启,放家里 NAS / 云服务器 / 旧笔记本上 24 小时在线。Server 内嵌完整 Web GUI(前端用 rust-embed 打进二进制),手机、平板、浏览器、另一台电脑打开 http://<server>:port 就是完整 React 界面——不用装客户端、不用配前端。Bearer Token 鉴权 + SSRF 三档策略保证公网暴露也可控;会话、记忆、Cron、IM 渠道全在服务端跑,客户端只是窗口。 |
| 🔁 三种运行模式同核 | 桌面 GUI(默认)、HTTP/WS 守护进程 + 内嵌 Web GUI(浏览器直连)、ACP stdio(给 IDE 当 agent 后端)。三种模式共用 Rust ha-core 核心库,零 Tauri 依赖——同一份代码既能当桌面 app,也能当服务器,也能嵌进 IDE。 |
| 模式 | 启动方式 | 场景 |
|---|---|---|
| 桌面 GUI | 双击图标 / pnpm tauri dev | 功能最全的入口:完整 GUI 体验,并内嵌 HTTP/WS 服务,桌面在用的同时可对外提供接入 |
| Server + Web GUI(HTTP/WS) | 通过 server start 子命令;server install 可注册成 launchd / systemd 开机自启 | 无 GUI 守护进程,24 小时在线,IM 渠道 / Cron 不断线;**前端 React UI 通过 rust-embed 内嵌进 server 二进制,浏览器打开 http://<server>:port 即得完整 Web GUI**,手机 / 平板 / 任意电脑都能直连 |
| ACP(stdio) | 通过 acp 子命令 | IDE 直连,兼容 ACP 协议的编辑器把 Hope Agent 当 agent 后端调 |
三种模式共用同一套 ha-core 核心逻辑;配置、会话、记忆全部落在 ~/.hope-agent/ 下。
| 📋 Plan Mode 计划执行 | 面对复杂任务先出一份可修改 / 可承接的计划书,5 态状态机管理执行进度,计划文件按 agent / session 物理隔离不会跨会话串戏。计划可跨会话存档,下次继续只要一句"继续上次的计划"。侧栏 Plans 历史查看器支持跨会话只读浏览所有 Plan(含已 /plan exit 归档),按 Agent / 状态筛选、版本切换、一键跳转所属会话;详情面板可一键以 @plan:<short_id>:v<version> 形式注入到当前对话。执行期间严格按白名单工具操作,避免模型跑飞。 |
| 📁 Project 项目容器 | 把相关会话归到同一项目下,继承项目级记忆 / 项目指令 / 共享文件。上传的文件自动文本抽取并三层注入(目录清单 / 小文件自动内联 / 大文件按需读取),不用手动 @ 文件也不怕吃爆上下文。 |
| 🖱️ 电脑控制 | 暂时仅支持 macOS。Agent 可以借助已授权的辅助功能与屏幕录制权限观察当前桌面、识别 AX 元素与窗口,并执行打开 / 切换 App、点击、输入、滚动、拖拽、菜单、对话框、窗口移动 / 缩放 / 关闭等操作。右侧 Mac Control 面板实时镜像桌面状态;所有有副作用的动作都接入统一工具审批。 |
| 👥 Agent Team 多 Agent 协作 | 在设置里预置团队模板(成员角色、绑定 Agent、默认任务模板),模型按需一句话就能组建专家团。成员间可互发消息、协同推进,完成后自动把 transcript 汇总回主对话。 |
| 🗓 自然语言定时任务 | "每天早 8 点给我写日报"、"每周一整理上周待办"、"工作日每小时扫一次邮箱"——到点自动跑,结果可选投递到任一 IM 渠道。Cron 在守护进程 / 桌面 GUI 下都能稳定运行。 |
| 📊 Dashboard + Recap 复盘 | 内置数据大盘:成本 / Token / 活跃度热力图 / 健康度四维可视化,新增 Plan 子板(状态分布、完成率、按 Agent / Project 分组、30 天创建趋势、平均执行时长)。/recap 深度复盘一键跑过去 N 天会话,生成 11 个 AI 章节报告(含 Agent 工具优化建议、记忆与技能推荐、成本优化等),可导出独立 HTML 分享。 |
| 🔌 MCP 客户端(OAuth 2.1) | 内置 Model Context Protocol 客户端,四种 transport 全支持:stdio / Streamable HTTP / SSE / WebSocket。完整 OAuth 2.1 + PKCE 流程(自动 discovery、RFC 7591 动态注册、loopback 回调),凭据 0600 原子写落盘,Notion / Linear 等标准 OAuth server 可一键授权;所有出站 URL 硬过 SSRF 策略。GUI 里一键从 claude_desktop_config.json 导入,工具自动以 mcp__<server>__<tool> 接入主对话;另配 mcp_resource / mcp_prompt 工具访问被动数据,长跑工具自动后台化。 |
| 🪝 Hooks 自动化 | 在会话、工具调用、上下文压缩、权限决策等 28 个生命周期事件上挂接自定义处理器,字段级兼容 Claude Code hooks 协议——社区脚本即插即用。支持 command / http / mcp_tool / prompt / agent 五种处理器;配置分 user / managed / project / local 四层作用域叠加合并,项目级 hooks(.hope-agent/hooks.json)可随仓库共享给团队。可视化设置面板配置,改动即时热重载。 |
| 🔧 工具箱 | 电脑控制(暂时仅 macOS)、可控浏览器(8-action 高层表面,chat 右侧实时镜像面板所见即所得,Chrome 自动跟随 agent 操作;CDP 直连 chromiumoxide,零运行时依赖)、Canvas 画布、AI 画图(7 个 Provider)、Web 搜索(8 个 Provider failover)、bash 执行(可选 Docker 沙箱隔离)、文件读写 / grep / find、URL 预览、崩溃日志、自诊断。 |
| 📑 飞书工作空间深度集成 | 40 个 feishu_* tool 覆盖 docx 云文档(建/读/改)、bitable 多维表格(CRUD + view + dashboard)、drive 云盘(上下传 ≤20MB,本地路径走 protected-path 审批)、wiki 知识库链接解析、approval 审批(创建/查询/撤销)、calendar 日历(建会/邀人/改/删)、contact 联系人(查用户/部门)、hire 招聘(岗位/人才库/投递)。复用已配的飞书 IM channel 凭据,配套 skills/feishu 技能教模型 OKR 周报 / 排会议 / 撤审批等典型工作流。 |
| ⚡ 后台跑长任务 | 耗时的 shell 命令 / Web 搜索 / AI 画图可以让 Agent "丢到后台跑",立即返回 job_id 继续对话不阻塞。后台完成后结果自动注入回主对话,也可以让模型主动 job_status poll 结果。再长的任务都不会卡住你的聊天窗。 |
Rust实现的MCP标准Agent框架,跨端交接和个性化学习特色明显。567星活跃度适中,架构创新度高,适合开发者和企业应用探索。
AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一,可自由商用、修改、分发,仅需保留版权声明。
经综合评估,hope-agent MCP工具 在AI工具赛道中表现稳健,质量优秀。如果你已有明确的使用需求,可以直接上手体验;如果还在评估阶段,建议对比同类工具后再做决策。
| 原始名称 | hope-agent |
| 原始描述 | 开源MCP工具:🦭跨端交接、越用越懂你的桌面 AI 助手——也能服务化常驻、跑在云上 | Desktop AI that hands off across your devi。⭐567 · Rust |
| Topics | MCP协议跨端交接桌面助手Rust开发云端部署 |
| GitHub | https://github.com/shiwenwen/hope-agent |
| License | MIT |
| 语言 | Rust |
收录时间:2026-05-16 · 更新时间:2026-05-19 · License:MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。