cosmicstack-labs/mercury-agent

这是什么？

核心功能

• 01权限层包含不可覆盖的 Shell 黑名单、按目录的读写范围、每个会话可切换的 Ask Me / Allow All 模式，以及带 SSRF 防护的 URL 抓取。
• 02Second Brain 记忆：自动抽取十类事实存入本地 SQLite，支持全文检索、每小时整合，并可用 `/memory` 查看和管理。
• 03多渠道连到同一个运行时：终端 UI、Telegram、Discord、Slack、Signal，以及提供聊天、看板和机器人控制台的本地 Web 面板。
• 04Mercury Code 在仓库中工作，实时展示计划，只有构建、测试或类型检查通过后才把任务标记为完成。
• 05Mercury Bots 是常驻的定时专用 Agent，可单独运行或以舰队形式委派任务，拥有各自的 token 预算并输出文件成果。
• 06支持 DeepSeek、OpenAI、Anthropic、Grok、Ollama、LM Studio 及任意 OpenAI 兼容端点的自动回退，并按每日 token 预算运行 Token Saver 模式。
• 07内置约 50 个工具，覆盖文件、Shell、git、GitHub、定时任务、子 Agent 与 Spotify，还可从 skills.mercuryagent.sh 安装社区技能。

适用场景

• 运行一个不会失忆的个人助手，关掉终端后任务仍继续执行。
• 让 Agent 在仓库里改代码，改动前有审批，完成后有构建或测试验证。
• 在共享的 Telegram 或 Discord 频道中使用同一个 Agent，并按管理员/成员区分权限。
• 安排周期性的调研或报告任务，把结果文件送到本地目录或聊天窗口。
• 把提示词、API Key 与会话数据保存在自己的磁盘上，而不是托管服务里。

快速上手

1. 1

   通过 npm 安装（需要 Node.js 22+）

   npm i -g @cosmicstack/mercury-agent
2. 2

   运行 Mercury 并完成设置向导

   mercury

使用前须知

• !一键安装脚本需要从网络直接运行，使用前需信任该外部脚本。
• !社区技能未经审核，安装前应先自行检查。
• !完整功能需要 LLM 服务商的 API 密钥或 Mercury Cloud 账户。

收录于专题

标签

常见问题

mercury-agent 是什么？

在本机常驻运行的开源 AI Agent，带本地记忆与权限管控，可通过 CLI、Telegram 等渠道访问。 Mercury Agent 是一个用 TypeScript 编写的 AI Agent，以单个后台进程常驻在用户自己的机器上，支持 macOS、Linux、Windows，以及 Android 上的 Termux。它会注册为登录服务并在崩溃后自动重启；无论从终端 UI、Telegram、Discord、Slack、Signal 还是绑定在 127.0.0.1 的本地 Web 面板访问，连到的都是同一个 Agent 和同一份记忆。

mercury-agent 可以免费使用吗？用的什么许可证？

mercury-agent 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

mercury-agent 还在维护吗？

活跃维护中。mercury-agent 最近一次提交是在 2026年11月6日。

mercury-agent 适合用来做什么？

运行一个不会失忆的个人助手，关掉终端后任务仍继续执行。 让 Agent 在仓库里改代码，改动前有审批，完成后有构建或测试验证。 在共享的 Telegram 或 Discord 频道中使用同一个 Agent，并按管理员/成员区分权限。 安排周期性的调研或报告任务，把结果文件送到本地目录或聊天窗口。 把提示词、API Key 与会话数据保存在自己的磁盘上，而不是托管服务里。

mercury-agent 怎么安装和运行？

通过 npm 安装（需要 Node.js 22+）: npm i -g @cosmicstack/mercury-agent 运行 Mercury 并完成设置向导: mercury

在哪里获取 mercury-agent？

源代码和安装说明在 GitHub 上：https://github.com/cosmicstack-labs/mercury-agent