Rook

rook-mcp

一个用于将文本保存到 macOS 上 Rook 笔记应用的模型上下文协议服务。使用 stdio JSON-RPC 2.0，提供一个工具：append_to_inbox。

当 MCP 客户端（Claude Desktop、Cursor、Claude Code、Codex、Gemini CLI 等）调用 append_to_inbox 时，此服务会将一行 JSON 写入 macOS 共享应用组容器。Rook 会清空该容器，并将每一行转换为收件箱中的一条笔记。

安装

rook-mcp 已包含在 Rook.app 中，路径为 Contents/Helpers/rook-mcp.app。从 userook.app 安装 Rook，然后将 MCP 客户端指向附带的二进制文件：

/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "rook": {
      "command": "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "rook": {
      "command": "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"
    }
  }
}

Claude Code

使用用户级作用域安装，这样便可从任何目录访问该服务：

claude mcp add rook -s user /Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp

Codex

codex mcp add rook -- /Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp

或者手动将其添加到 ~/.codex/config.toml：

[mcp_servers.rook]
command = "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"

Gemini CLI

~/.gemini/settings.json：

{
  "mcpServers": {
    "rook": {
      "command": "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"
    }
  }
}

Gemini CLI 首次使用该服务时会提示你确认信任。

工具

append_to_inbox

将文本保存到用户的 Rook 笔记应用中。当用户要求在 Rook 中保存、收集、记住、记下、记录、添加或暂存内容时，模型应调用此工具。

输入：

字段	类型	必填	备注
content	字符串	是	要保存的文本。最多 100,000 个字符。
title	字符串	否	显示在内容上方的简短标题。最多 200 个字符。

**响应：**类似 Saved to Rook inbox 2026-05-12 under "Test" 的确认信息。

错误：

代码	标识	含义
-32600	invalid request	缺少 jsonrpc 版本或版本错误，或在 initialize 之前调用了方法
-32001	entitlement_unavailable	无法访问应用组容器（未签名的构建）
-32002	rate_limited	最近 60 秒内写入次数超过 100 次
-32003	paused	MCP 在 Rook 中已暂停（Settings → MCP → Resume）
-32004	input_invalid	内容或标题未通过验证，或参数格式错误
-32005	store_write_failed	无法将文件写入收件箱

构建

需要 Swift 5.9+ 和 macOS 14+：

swift build -c release

由于缺少 Rook 的团队 ID 签名和应用组权限，每次调用工具时，生成的二进制文件都会返回 entitlement_unavailable。只有 Rook.app/Contents/Helpers/ 中的二进制文件才能向 Rook 传递内容。

安全

有关信任边界、清理程序、速率限制、暂停标志和漏洞报告政策，请参阅 SECURITY.md。