에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
｜写下的东西，会留下回响
Penpal MCP 是面向 macOS AI Agent 的本地优先记忆层，也是 stdio MCP server。它连接 Claude Code、Codex、Cursor，按你启用的来源记录应用与窗口切换、剪贴板和过滤后的键盘文本，并导入支持的本地历史、会话、Git 与 Markdown 数据。Penpal 服务与数据库完全在 Mac 本机运行，不内置大模型；返回内容会进入你所用 AI Host 的对话，也可能被发送到该 Host 的云端模型服务。
English · · ·
Penpal MCP: a local-first memory layer for AI agents on macOS. Gives Claude Code, Codex and Cursor searchable, cited memory of your browsing, clipboard, windows and past AI sessions, with per-agent grants and redaction. No cloud, no built-in LLM.
你在 Claude Code 里问："上周我看过一个讲 MCP 鉴权的网页，在哪？" 它答不上来。它没见过你的浏览器；就算让它跑 bash 去翻，浏览器历史 90 天后会过期，剪贴板、切过的窗口、在网页输入框里打过的字，本来就没落盘，事后谁也找不回。
装了 Penpal 之后，同一个问题，AI 调用 search_context，返回那条网页记录、你当时在哪个 App 里、前后在做什么，再用 get_evidence 打开原始出处，你自己核对是不是它。
Penpal 不做聊天入口，也不内置大模型。你继续在自己常用的 AI 里提问，Penpal 只负责"记得"和"给得准"。
AI 自己能读本机文件，只给已有文件建个索引，没必要单独装一个工具。Penpal 存在的理由只有下面三条，每个功能都要落在其中一条上，并且在对照评测里比"AI + bash"答得好：
App 能做的事，CLI 都能做。Penpal 会在 ~/Applications/Penpal.app 编译一个原生启动器，在独立应用身份下运行后台服务与 HUD；系统权限与菜单栏均显示为 Penpal。如果本机缺少 clang 或 libpython，会退回脚本启动器并提示权限列表与菜单栏可能显示 Python。首次安装后从 Finder 打开 ~/Applications/Penpal.app，并在系统设置的「菜单栏」里确认 Penpal 可见；CLI 仍可通过 doctor/status 检查 HUD 状态。
# 1. 安装 CLI，初始化运行环境，注册开机自启的后台服务
curl -fsSL https://raw.githubusercontent.com/Longfellow1/penpal/main/install.sh | bash
# 或手动：brew install longfellow1/penpal/penpal && penpal install init
# 2. 检查系统权限：缺哪个、该给哪个程序授权、去哪个设置面板，doctor 都会列出来
penpal doctor
# 3. 授权一个 AI，并按提示把配置加进去（命令会直接打印 Claude Code / Codex / Cursor 的配置）
penpal mcp grant claude --buckets Work,Personal
然后在 Claude Code 里正常提问，比如"我昨天下午在研究什么"。
想要菜单栏界面（可选）：
penpal app install # 编译原生启动器并在 ~/Applications 生成 Penpal.app；加 --login 开机自启
penpal app uninstall # 移除 App 和启动项，不影响后台服务与数据
安装后从 Finder 打开 Penpal.app。macOS 26 可在「系统设置 → 菜单栏 → 允许在菜单栏中」开启 Penpal；若图标缺失，先看 penpal doctor 和 penpal hud status。macOS 对菜单栏项目可见性的公开探测有限；从系统设置关闭项目时，HUD 不一定能自动识别。
升级后运行 penpal doctor。遗留文件 部分会以 WARN 列出旧版 KeyPulse.app、旧 PID/日志、旧 launchd plist 和迁移后留下的 ~/.keypulse 目录，并给出建议命令。doctor 只报告，不会移动或删除 App；确认旧 App 后，可手动运行它列出的 mv … ~/.Trash/ 命令，或在 Finder 中移到废纸篓。
运行 penpal maintenance clean-legacy 只会删除 ~/.penpal 内的旧 keypulse*.pid 和 keypulse*.log 普通文件，不会处理 App、launchd plist 或 ~/.keypulse。清理后再次运行 penpal doctor；仍需处理的项目会继续列出。旧 keypulse.log 仅在 penpal.log 不存在时迁移一次；两者都存在时保留旧文件并由 doctor 报告。
daemon 单独写入轮转的 penpal.log（5 MiB，最多 3 个备份）。launchd 的 daemon/healthcheck stdout 与 stderr 文件限制为 1 MiB，并在运行期间按原文件截断超限内容。
只读：AI 不能写入或修改记忆（rate_result 只在本机记一条评分）。查到的内容会进入该 AI 的对话，可能发送到它的云端服务。授权时按分类（Work / Personal / Private / Financial）限定，penpal mcp audit 能看到谁在什么时候查过、结果有几条，不记录查询内容。
注意：Work 包含 Claude Code / Codex 里的全部对话，也可能包含私人项目。查看已导入的项目和当前分桶用 penpal rules projects；要把项目归到 Personal，按项目目录名执行 penpal rules add --scope project --value <项目目录名> --bucket Personal，再运行 penpal rules rebucket 更新已有记录。
会记录（每个来源都能单独关）：
~/.penpal/config.toml 的 [watchers] 里设 browser_url = false不会记录或默认排除：
penpal source disable keyboard_chunk）数据只在你本机 ~/.penpal/，没有云端、没有埋点。不会自动删除，删除由你决定，删的时候原文、索引、出处、相关查询记录一起清掉。
逐条可核对的隐私边界（附代码与测试出处）：docs/privacy.md
完整参考：penpal --help。
网站屏蔽会覆盖该域名及其子域名。更改后运行 penpal restart，新事件会在后台重新加载配置后按新清单处理。
penpal app install）。Apache 2.0，见 LICENSE。
Harland，AI Native 产品经理。邮箱：[email protected]
Penpal MCP: a local-first memory layer for AI agents on macOS. Gives Claude Code, Codex and Cursor searchable, cited memory of your browsing, clipboard, windows and past AI sessions, with per-agent gr
개요
Penpal MCP: a local-first memory layer for AI agents on macOS. Gives Claude Code, Codex and Cursor searchable, cited memory of your browsing, clipboard, windows and past AI sessions, with per-agent grants and redaction. No cloud, no built-in LLM.
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Penpal은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-11. Penpal MCP: a local-first memory layer for AI agents on macOS. Gives Claude Code, Codex and Cursor searchable, cited memory of your browsing, clipboard, windows and past AI sessions, with per-agent grants and redaction. No cloud, no built-in LLM.
