如何在 Mac 上部署 OpenChronicle完整安装 MCP 接入实战教程【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicleOpenChronicle 是一款开源、本地优先的 Mac AI 记忆工具它自动捕捉你屏幕上的上下文AX Tree 截图压缩成可检索的 Markdown 记忆再通过 MCP 协议开放给 Claude Code、Cursor 等 AI 助手。本文是一份完整的 OpenChronicle 安装部署 MCP 接入实战教程无需开发背景跟着做 10 分钟即可跑起来。30 秒认识 OpenChronicle简单来说OpenChronicle 做的事情是捕捉屏幕上下文 → 压缩成会话 → 提取长期事实 → 存成本地记忆 → 供 AI Agent 查询。特性说明 本地优先所有记忆都留在你自己的 Mac 上~/.openchronicle/不上传云端 模型无关支持 OpenAI、Anthropic、Ollama 等任意兼容的模型服务 MCP 接口内置常驻 MCP 服务端Claude Code / Codex / Cursor 等一键接入 可检查记忆是纯 Markdown 本地 SQLite 索引随时可读、可改、可 diff更多设计细节可以看看 docs/architecture.md。部署前检查Mac 系统要求与前置条件OpenChronicle 目前仅支持 macOS部署前请确认以下 4 项检查项命令要求系统版本sw_vers -productVersionmacOS 13 及以上命令行工具xcode-select -p已安装用于编译 AX 辅助二进制Pythonpython3 --version3.11没有也没关系脚本会用 uv 自动装 3.12uvwhich uv没有会自动安装如果缺少 Xcode Command Line Tools运行一次即可xcode-select --install三步完成 OpenChronicle 安装部署第一步克隆仓库git clone https://gitcode.com/gh_mirrors/op/OpenChronicle.git cd OpenChronicle第二步运行安装脚本bash install.shinstall.sh 会自动完成 5 件事校验 macOS 版本与 Xcode 命令行工具确保 uv 可用缺失时自动安装在~/.openchronicle/venv创建虚拟环境并安装 OpenChronicle编译 macOS AX 辅助二进制mac-ax-helper / mac-ax-watcher在~/.local/bin生成openchronicle命令并自动运行status验证安装脚本结束时还会询问是否把 MCP 配置注入到已检测到的客户端Claude Code、Claude Desktop、Codex、opencode。常用选项--yes自动注入所有检测到的客户端--no-client-config跳过注入稍后手动配置--bin-dir path自定义openchronicle命令的安装目录第三步验证安装openchronicle status首次运行会在~/.openchronicle/config.toml生成默认配置。如果提示openchronicle不是命令说明~/.local/bin不在 PATH 中在 shell 配置里加一行export PATH$HOME/.local/bin:$PATH即可。配置模型云端 API 与本地 Ollama 两种方案OpenChronicle 的记忆压缩依赖 LLM配置都在~/.openchronicle/config.toml用openchronicle config可随时查看当前生效的配置。方案 A云端模型最省心[models.default] model gpt-5.4-nano api_key_env OPENAI_API_KEY # 把 API Key 放在同名环境变量里方案 B本地 Ollama完全离线[models.default] model ollama/qwen2.5:14b base_url http://localhost:11434 api_key_env # 本地模型留空模型还可以按 4 个阶段分别指定默认全部继承[models.default]阶段运行时机选型建议timeline每分钟便宜但要稳需支持 JSON 输出reducer会话结束时稍强一点的模型classifier每 30 分钟最吃能力必须支持工具调用compact记忆文件过大时与 classifier 同级即可修改配置后重启守护进程并探测模型连通性openchronicle stop openchronicle start openchronicle status # 会逐个探测模型✓ 表示成功完整的配置说明见 docs/config.md。启动守护进程让 OpenChronicle 开始记录openchronicle start⚠️关键一步授权辅助功能。OpenChronicle 通过 macOS 的 AXAccessibilityAPI 读取屏幕上下文必须给终端 AppTerminal / iTerm2 / Warp 等以及openchronicle本身授权系统设置 → 隐私与安全性 → 辅助功能勾选后重启守护进程。常用命令一览命令作用openchronicle status查看运行状态与模型探测结果openchronicle pause/resume暂停 / 恢复捕获openchronicle stop停止守护进程openchronicle capture-once手动触发一次捕获验证授权是否生效openchronicle timeline list查看已生成的 1 分钟时间线块openchronicle rebuild-index从 Markdown 重建 SQLite 搜索索引正常使用一段时间后打开~/.openchronicle/memory/目录看看你会看到event-2026-09-30.md、user-profile.md、project-*.md等记忆文件自动生成——记忆文件格式说明见 docs/memory-format.md。MCP 接入实战一条命令连接你的 AI 助手守护进程默认在http://127.0.0.1:8742/mcp提供一个常驻的只读 MCP 服务主流客户端都有一键接入命令客户端接入命令移除命令Claude Codeopenchronicle install claude-codeopenchronicle uninstall claude-codeCodex CLIopenchronicle install codexopenchronicle uninstall codexopencodeopenchronicle install opencodeopenchronicle uninstall opencodeClaude Desktopopenchronicle install claude-desktopopenchronicle uninstall claude-desktop没有一键命令的框架Cline、Continue、Zed 等可以生成一段通用配置openchronicle install mcp-json --http把输出合并进对应框架的 MCP 配置即可。接入后可以直接这样问你的 AI 助手「我现在在做什么」→ 调用current_context返回屏幕上最新的实时上下文「我上周的面试安排是什么」→ 调用search做全文检索「把 14:30 我在编辑器里写的代码找出来」→ 调用read_recent_capture钻取原始捕获所有 MCP 工具都是只读的实现见 src/openchronicle/mcp/server.pyAI 只能查、不能改你的记忆。完整的工具清单与客户端细节见 docs/mcp.md。常见问题排查清单症状大概率原因解法捕获内容为空终端没开辅助功能权限给终端 openchronicle 授权重启守护进程端口 8742 被占用其他进程占着端口lsof -i :8742找到并处理AI 客户端连不上 MCP守护进程没跑 /auto_start被关openchronicle status检查后再试搜索不到已存在的记忆索引漂移openchronicle rebuild-indexstatus显示已运行但实际挂了残留 PID 文件删掉~/.openchronicle/.pid再start更多按日志定位问题的排错思路参考 docs/troubleshooting.md日常调试也可以tail -F ~/.openchronicle/logs/*.log一把梭。总结回顾一下整个 OpenChronicle 部署流程其实只有 5 步✅ 确认 macOS 13 与 Xcode 命令行工具✅git clonebash install.sh一键安装✅ 在config.toml配置模型云端或本地 Ollama✅ 授权辅助功能后openchronicle start✅openchronicle install 客户端完成 MCP 接入从此你的 AI 助手不再只记得当前对话——它还记得你在做什么、和谁协作、用过哪些工具而这些数据全部留在你自己的 Mac 上。动手试试吧【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicle创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考