← 返回目录

Atomic Agent

社区

非标准 Server

运行在本机的本地优先 AI 智能体。

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 187 / 230
Stars: ★ 3.4k 非常热门
运行环境: Node.js 25.7+ · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 6 天前

44FMRS · D

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

最强项 · 文档质量 13/20 最弱项 · 可靠性 3/20

可靠性

3/20

安全与权限

10/20

维护活跃度

10/20

文档质量

13/20

安装易用性

8/20

查看各项评分依据

可靠性 3/20: 静态材料未提供缓存的服务器清单、MCP 初始化流程、工具列表或测试文件证据；README 主要描述一个可连接外部 MCP 的本地代理，而非已声明的 MCP 服务器。因此无法验证握手、工具契约、错误处理或关键路径，按静态校准大幅扣分。
安全与权限 10/20: README 明确说明 shell、文件写入、补丁、HTTP、进程终止和不受信任的 MCP 工具具有审批门，并披露网络外发范围和本地状态位置。扣分原因是权限边界和实现证据缺失，技能与 shell 继承包括 .env 在内的进程环境，且 README 明确承认秘密脱敏并非完整隔离；任意 HTTP、浏览器和外部 MCP 的数据流仍需依赖配置与审批。
维护活跃度 10/20: 材料显示项目未归档，提供 MIT 许可证、GitHub issues、发布流程徽章和版本入口，并标注开发预览。扣分原因是没有提交历史、维护者响应、依赖更新、安全响应流程或版本稳定性证据，README 还说明 API、命令和配置仍在变化。
文档质量 13/20: README 覆盖安装、运行方式、平台要求、配置、秘密位置、能力范围、隐私外发、限制、故障排查和多种使用模式，且给出 MCP 客户端配置示例。扣分原因是没有服务器 manifest、实际工具参数/返回契约、主流 MCP 客户端连接示例或可核验的测试证据；文档中还存在开发预览和平台限制。
安装易用性 8/20: 提供 macOS/Linux shell 安装器、Windows PowerShell 安装器、运行命令、状态目录和 MCP 客户端配置片段。扣分原因是需要 Node/llama-server/Chromium/git 等多项环境，模型与浏览器还需额外配置，且材料没有证明该仓库可作为 MCP 服务器直接接入主流客户端；没有 manifest 或标准 MCP 启动配置。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络控制浏览器

适合谁

希望控制循环和状态保留在本机的用户
拥有兼容 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 工具虽有审批策略，但错误批准仍可能造成影响
项目仍处于开发预览阶段，命令、配置和行为可能变化

安装接入

准备工作

运行环境：Node.js 25.7+ · 预编译二进制

ATOMIC_AGENT_LLAMA_API_KEY 可选密钥外部 llama-server 的可选 Bearer token,用于鉴权,需自备。

TELEGRAM_BOT_TOKEN 可选密钥 Telegram 远程控制用的 bot token,从 @BotFather 创建 bot 获取,写入 <stateDir>/.env。

其他可选配置项（7 个）

ATOMIC_AGENT_STATE_DIR 可选指定状态目录(config、记忆、任务、traces 等),默认 ~/.atomic-agent。

ATOMIC_AGENT_LLAMA_URL 可选外部 llama-server 的地址,例如 http://127.0.0.1:8080。

ATOMIC_AGENT_LLAMA_MAX_TOKENS 可选设置单次补全的 token 上限。

ATOMIC_AGENT_BROWSER_CHANNEL 可选选择浏览器通道,可选 chrome、msedge 或 chromium。

ATOMIC_AGENT_BROWSER_EXECUTABLE_PATH 可选显式指定 Chromium 系浏览器可执行文件路径。

ATOMIC_AGENT_BROWSER_CDP_URL 可选通过 CDP 连接到已在运行的浏览器实例。

ATOMIC_AGENT_UPDATE_CHECK_ON_STARTUP 可选设为 false 可跳过启动时的 GitHub Releases 版本检查。

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

验证是否装好

安装后运行 `atomic-agent`,若 TUI 正常启动并出现交互界面(可用 /help 列出命令),即说明安装成功;也可运行 `atomic-agent models list` 查看本地模型。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

打开浏览器搜索今天的科技新闻并总结要点
读取我桌面上的 PDF 并提取其中的文本
把这段代码文件里的 bug 修掉,改动前先征求我的确认
明早 9 点给我发一份每日摘要到 Telegram

使用场景

在本机运行长上下文、多步骤 AI 任务

自动化浏览器操作和网页访问

读取、编辑和搜索本地文件

运行需要审批的 shell 命令

通过 MCP 连接外部工具、资源和提示

使用本地记忆和定时任务执行持续工作流

详细介绍

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