Hope Agent
🦭跨端交接、越用越懂你的桌面 AI 助手——也能服务化常驻、跑在云上 | Desktop AI that hands off across your devices and gets to know you better — also runs headless on a NAS or in the cloud
What is Hope Agent?
Hope Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🦭跨端交接、越用越懂你的桌面 ai 助手——也能服务化常驻、跑在云上 | desktop ai that hands off across your devices and gets to know you better — also runs headless on a nas or in the cloud
🦭跨端交接、越用越懂你的桌面 AI 助手——也能服务化常驻、跑在云上 | Desktop AI that hands off across your devices and gets to know you better — also runs headless on a NAS or in the cloud
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 🦭跨端交接、越用越懂你的桌面 AI 助手——也能服务化常驻、跑在云上 | Desktop AI that hands o
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx hope-agentConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Hope Agent
Hope Agent is a cross-platform desktop AI assistant built with Rust and Tauri that supports 44 model providers and 335 preset models, including Anthropic, OpenAI, DeepSeek, and local Ollama models. It stores conversations, memories, and attachments locally in SQLite with semantic and full-text search, syncs cross-device memory through a plan-based workflow system, and can run headless as a server on a NAS or in the cloud. Users choose it for persistent, private AI assistance that learns across sessions without sending data to third-party intermediaries.
Prerequisites
- macOS, Windows, or Linux operating system
- API key for at least one model provider (Anthropic, OpenAI, DeepSeek, etc.) or Ollama running locally
- Docker installed if using the self-hosted server deployment
- An MCP-compatible client if connecting via the ACP stdio protocol
- Port 8420 available if running in server daemon mode
Install Hope Agent
Install using the package manager for your platform. macOS users should use Homebrew; Windows users should use Scoop; Linux users should add the apt repository.
# macOS
brew tap shiwenwen/hope-agent
brew install --cask hope-agent
# Windows
scoop bucket add hope-agent https://github.com/shiwenwen/scoop-hope-agent
scoop install hope-agent
# Docker (self-hosted)
docker run -d --name hope-agent -p 127.0.0.1:8420:8420 \
-v hope-data:/data ghcr.io/shiwenwen/hope-agent:latestLaunch the application
Start Hope Agent as a desktop app by double-clicking the icon, or launch it as a background server daemon to access it from a browser or IDE.
# Desktop GUI
hope-agent
# Server daemon (headless)
hope-agent server start
# Then open: http://localhost:8420Configure your model provider
Open Settings in the Hope Agent UI and add your API key for your preferred model provider. Keys are stored locally in ~/.hope-agent/ and never sent to intermediaries.
Connect via MCP (ACP protocol)
Use the ACP stdio protocol to integrate Hope Agent as an MCP server in Claude Desktop or another MCP client.
hope-agent acpEnable cross-device memory sync
Configure cloud sync (iCloud, Dropbox, or a shared volume) to point to the ~/.hope-agent/ data directory so memories and sessions are available across all your devices.
Hope Agent Examples
Client configuration
Configure Claude Desktop to connect to Hope Agent using the ACP stdio protocol.
{
"mcpServers": {
"hope-agent": {
"command": "hope-agent",
"args": ["acp"]
}
}
}Prompts to try
Example prompts that leverage Hope Agent's memory, multi-model, and task planning capabilities.
- "What did we discuss about the project last week?"
- "Switch to DeepSeek and summarize my last 5 conversations"
- "Create a plan to refactor the authentication module and track progress"
- "Send a message to my Telegram contact about the meeting tomorrow"
- "Search my memory for anything related to database optimization"Troubleshooting Hope Agent
Port 8420 is already in use when starting server mode
Check which process is using the port with 'lsof -i :8420' on macOS/Linux or 'netstat -ano | findstr 8420' on Windows, then stop that process or configure Hope Agent to use a different port in ~/.hope-agent/config.
API key is not being recognized for a model provider
Verify the key in Settings and confirm it has the correct permissions for the model you selected. Hope Agent connects directly to provider APIs, so ensure there are no proxy or firewall rules blocking outbound HTTPS to the provider's endpoint.
Memory from previous sessions is not appearing
Check that the data directory ~/.hope-agent/ exists and is not empty. If you changed machines, verify the sync path is pointing to the correct shared folder. Memory consolidation runs offline in the background ('dream' mode), so allow a few minutes after launch.
Frequently Asked Questions about Hope Agent
What is Hope Agent?
Hope Agent is a Model Context Protocol (MCP) server that 🦭跨端交接、越用越懂你的桌面 ai 助手——也能服务化常驻、跑在云上 | desktop ai that hands off across your devices and gets to know you better — also runs headless on a nas or in the cloud It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Hope Agent?
Follow the installation instructions on the Hope Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Hope Agent?
Hope Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Hope Agent free to use?
Yes, Hope Agent is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Hope Agent Alternatives — Similar Coding Agents Servers
Looking for alternatives to Hope Agent? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Hope Agent in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Hope Agent?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.