Truepath Recorder

TruePath Recorder MCP (truepath-mcp)

AI エージェント（Claude Desktop、Claude Code、Codex、Cursor、または任意の MCP クライアント）から、macOS ネイティブの画面収録アプリ TruePath Recorderを操作できるMCPサーバーです。収録の開始、停止、状態確認、キャプチャソースの一覧表示ができ、保存したファイルのパスを取得できます。

薄型のローカルブリッジです。収録データが Mac の外に出ることはありません。

このサーバーはTruePath Recorder に同梱されています（Contents/MacOS/truepath-mcp）。ほとんどのユーザーは、クローンやビルドを行う必要はありません。このリポジトリは、そのバイナリのオープンソース版です。透明性を確保し、単体でビルドできるように公開しています。

必要条件

• Mac App Store で配信されているTruePath Recorder。
• アプリで Settings → AI Agent Control → on に設定します（デフォルトではオフです）。これにより、この MCP が通信するローカルのトークン保護付き制御サーバーが起動します。

クイックスタート

1. TruePath Recorder を開き、Settings → AI Agent Control からオンにします。
2. 使用するエージェント（Claude Desktop／Claude Code／Codex／Cursor）の横にある Copy をクリックします。同梱バイナリのパスが入力済みの、以下の設定スニペットがコピーされます。
3. ホストの MCP 設定に貼り付けて、ホストを再起動します。
4. エージェントに「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

アプリは共有 App Group コンテナに {port, token} のハンドシェイクを書き込みます。truepath-mcp はそれを読み取り、アプリの localhost 専用制御サーバーを呼び出します。デバイス外には何も公開されません。

プライバシーとセキュリティ

• デフォルトではオフです。エージェントごとに有効化できます。
• 制御サーバーは 127.0.0.1 のみで待ち受け、起動ごとに生成されるトークンを必要とします。
• サーバーが開始・停止するのは、アプリの UI から行うものと同じキャプチャだけです。収録データなどをアップロードすることはありません。

ソースからビルドする（単体）

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

単体ビルドの場合も、TruePath Recorder アプリ（AI Agent Control をオンにした状態）が必要です。アプリが書き込むものと同じ App Group ハンドシェイクを読み取ります。

ライセンス

MIT © Joy Truepath Pte. Ltd. — LICENSE を参照してください。