← 返回目录
A

Atomic Agent

社区
运行在本机的本地优先 AI 智能体。
GitHub 源仓库 ↗
★ 2.4k Stars 分类 · 其他 非常热门 源版本 86321a419c9e
44FMRS · D
可靠性
3/20
安全与权限
10/20
维护活跃度
10/20
文档质量
13/20
安装易用性
8/20

资料显示 Atomic Agent 是一个本地优先 AI 智能体和 MCP 客户端,不是可直接登记为 MCP server 的实现。它功能范围广,强调本地模型、审批和可观察性,但需要较多系统权限,并且仍处于开发预览阶段。

查看 FMRS 评分方法 →

Atomic Agent 是一个运行在用户设备上的本地优先 AI 智能体,支持本地或云端模型。它可以驱动浏览器、读写文件、运行经批准的 shell 命令、提取文档文本、保存跨会话记忆、安排任务,并连接外部 MCP 服务器。该项目本身是 MCP 客户端而非已声明传输方式的 MCP 服务器。

工具能力

暂未整理工具清单。

安装接入

macOS 或 Linux 可运行 curl -fsSL https://atomicagent.io/install | sh;Windows PowerShell 可运行 irm https://atomicagent.io/install.ps1 | iex。安装后运行 atomic-agent。项目处于开发预览阶段,集成时应固定版本。

选型与风险

适合谁

  • 希望控制循环和状态保留在本机的用户
  • 拥有兼容 llama.cpp、Ollama、LM Studio 或其他 OpenAI 兼容后端的用户
  • 需要浏览器、文件系统、文档和任务自动化的开发者
  • 愿意审查审批、日志和网络外发范围的技术用户

不适合谁

  • 需要一个可直接被 MCP 客户端安装的独立 MCP 服务器的用户
  • 需要稳定不变 API 的生产集成,因为项目仍是开发预览版
  • 不希望代理访问浏览器、文件、shell 或外部网络的环境
  • 无法提供 Node.js、Chromium、git 或可访问模型后端的环境

所需权限

  • 本地文件和 SQLite 状态目录的读写权限
  • 运行经批准的 shell 命令及部分进程操作的权限
  • 访问配置的 Chromium 浏览器、浏览器配置文件和网页网络
  • 访问配置的 llama-server、云端模型、搜索服务或其他 HTTP 端点
  • 使用外部 MCP 服务器时,对其工具调用的相应权限
  • 可选的 macOS 辅助功能、屏幕录制、自动化或提醒权限

风险与副作用

  • 浏览器、HTTP 工具、云端模型、搜索服务、MCP、Telegram、更新检查及分析功能可能产生网络外发
  • shell 命令和技能继承代理进程环境,可能接触 `.env` 密钥
  • 状态目录中的 traces 和 `.env` 应视为敏感本地文件;项目明确说明脱敏和环境过滤并非完整隔离
  • 文件写入、补丁、归档解压、进程终止、HTTP 请求和不受信任 MCP 工具虽有审批策略,但错误批准仍可能造成影响
  • 项目仍处于开发预览阶段,命令、配置和行为可能变化

常见排障

  1. 确认 Node.js、git、Chromium 系浏览器和可访问的 llama-server 或其他模型后端已准备好
  2. 检查浏览器可执行文件、浏览器频道和 CDP 配置是否正确
  3. 在 Linux 上确认 ripgrep、剪贴板、通知和窗口控制依赖是否已安装
  4. 若 Chrome 在特定 Linux 环境无法启动,检查沙箱配置和项目建议的 `--no-sandbox` 选项
  5. 检查模型服务的健康状态、模型名称、端口和 OpenAI 兼容路径
  6. 检查 MCP 配置中的命令、参数、启用状态和信任级别;连接失败时查看暴露的 stderr 尾部
  7. 检查审批策略、重复工具调用保护、日志和本地 NDJSON traces
  8. 若遇到问题,收集错误日志和系统规格后提交 GitHub issue 或在 Discord 求助

使用场景

在本机运行长上下文、多步骤 AI 任务
自动化浏览器操作和网页访问
读取、编辑和搜索本地文件
运行需要审批的 shell 命令
通过 MCP 连接外部工具、资源和提示
使用本地记忆和定时任务执行持续工作流

支持客户端

暂未确认支持的客户端。