Truepath Recorder

TruePath Recorder MCP（truepath-mcp）

一个 MCP 服务，可让你的 AI Agent——Claude Desktop、Claude Code、Codex、Cursor 或任何 MCP 客户端——操控原生 macOS 屏幕录制工具 TruePath Recorder：开始、停止和检查录制，列出录制来源，并返回已保存文件的路径。

这是一个轻量的本地桥接工具。你的录制内容绝不会离开 Mac。

此服务已随 TruePath Recorder 一同打包（Contents/MacOS/truepath-mcp）——大多数用户无需克隆或构建任何内容。本仓库是该二进制文件的开源版本，供用户了解其实现，并可独立构建。

要求

• 从 Mac App Store 获取 TruePath Recorder。
• 在应用中开启设置 → AI Agent 控制（默认关闭）。这会启动一个受令牌保护的本地控制服务，供此 MCP 连接。

快速开始

1. 打开 TruePath Recorder → 设置 → AI Agent 控制 → 开启该功能。
2. 点击你的 Agent（Claude Desktop / Claude Code / Codex / Cursor）旁边的复制——它会复制下方的配置片段，并自动填入已打包二进制文件的路径。
3. 将配置片段粘贴到宿主的 MCP 配置中，然后重启宿主。
4. 向你的 Agent 提问：“使用 TruePath 录制一段 10 秒的屏幕视频。”

配置片段

已打包二进制文件通常位于： /Applications/TruePath Recorder.app/Contents/MacOS/truepath-mcp

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "truepath": { "command": "/Applications/TruePath Recorder.app/Contents/MacOS/truepath-mcp" } } }

Claude Code

claude mcp add truepath -- "/Applications/TruePath Recorder.app/Contents/MacOS/truepath-mcp"

Codex — ~/.codex/config.toml

[mcp_servers.truepath]
command = "/Applications/TruePath Recorder.app/Contents/MacOS/truepath-mcp"

Cursor — ~/.cursor/mcp.json

{ "mcpServers": { "truepath": { "command": "/Applications/TruePath Recorder.app/Contents/MacOS/truepath-mcp" } } }

工具

工具	功能
get_status	idle / starting / recording / paused 状态，以及已用秒数
list_sources	可录制的显示器和窗口（含 ID），用于窗口/区域录制
start_recording	开始录制。所有参数均为可选：mode（display/window/area）、mic、system_audio、codec（h264/hevc）、display_id、window_id
stop_recording	停止录制并返回已保存文件的路径、时长和大小

工作原理

AI host ──(MCP, stdio)──> truepath-mcp ──(HTTP 127.0.0.1 + token)──> TruePath Recorder

应用会将 {port, token} 握手信息写入共享的 App Group 容器；truepath-mcp 会读取该信息，并调用应用仅限本机的控制服务。任何内容都不会暴露到设备之外。

隐私与安全

• 默认关闭；你可以为每个 Agent 单独选择开启。
• 控制服务仅绑定到 127.0.0.1，并要求提供每次启动时生成的令牌。
• 服务只能启动或停止与应用界面相同的录制；绝不会上传录制内容或其他任何内容。

从源代码构建（独立构建）

swift build -c release
# binary at .build/release/truepath-mcp — point your host's config there

独立构建仍需要 TruePath Recorder 应用（并开启 AI Agent 控制）；它会读取应用写入的同一 App Group 握手信息。

许可证

MIT © Joy Truepath Pte. Ltd. — 详见 LICENSE。