Hostbeam

Hostbeam MCP サーバー

Hostbeam は、Mac または iPhone のスクリーンショットを SSH 経由でサーバーに送信し、リモートパスをクリップボードにコピーするため、そこで実行中のコーディングエージェントに貼り付けられます。

この MCP サーバーは、エージェントと同じサーバー上で動作します。エージェントは、直前に送信したスクリーンショットを要求して読み取れるため、パスを貼り付ける必要はありません。

インストール

エージェントが動作しているサーバーにインストールします。Mac やスマートフォンにはインストールしません。Node 18 以降が必要です。

Claude Code の場合：

claude mcp add -s user hostbeam -- npx -y @hostbeam/mcp

-s user を指定すると、そのサーバー上のすべてのプロジェクトで利用できるようになります。

Codex の場合：

codex mcp add hostbeam -- npx -y @hostbeam/mcp

その他の MCP クライアントでは、JSON 設定に次の内容を追加します。

{
  "mcpServers": {
    "hostbeam": {
      "command": "npx",
      "args": ["-y", "@hostbeam/mcp"]
    }
  }
}

サーバーから npm にアクセスできない場合は、hostbeam-mcp.mjs をサーバーにコピーして、代わりにそれを実行します。依存関係はありません。

claude mcp add -s user hostbeam -- node /path/to/hostbeam-mcp.mjs

Hostbeam は、そのホスト用のフォルダーを変更していない限り、/tmp/hostbeam に画像を送信します。変更した場合は、同じフォルダーをサーバーにも指定します。Claude Code では -e HOSTBEAM_DIR=/your/folder、Codex では --env HOSTBEAM_DIR=/your/folder、JSON では "env": { "HOSTBEAM_DIR": "/your/folder" } を指定します。

ツール

• latest_screenshot は、直近に届いた画像を、届いてからの経過時間とともに返します。一度に複数のファイルを送信した場合は、最大 6 件までをすべて返し、残りのファイル名も表示します。
• list_screenshots は、最近送信された画像のファイル名、サイズ、時刻を一覧表示します。画像データは含まれません。
• read_screenshot は、指定したファイル名のファイルを返します。

読み取り対象

Hostbeam が配信したファイルのみが対象です。ファイル名が hostbeam- で始まり、画像拡張子を持つファイルが、そのフォルダー内にある場合に限ります。サブフォルダーは検索せず、パスを含む名前は受け付けません。ファイルへの書き込み、移動、削除は一切行いません。

シンボリックリンクはスキップします。また、ほかのユーザーが所有するフォルダーや、すべてのユーザーが書き込み可能なフォルダーは読み取りません。そこにあるファイルは、あなたが送信したものではない可能性があるためです。

JPEG、PNG、GIF、WebP は画像として返されます（各ファイル最大 3.75 MB）。その他の形式や、これより大きなファイルはパスとして返されます。モデルが受け付ける形式はこの 4 種類のみで、モデル API はサイズの大きな画像を拒否するためです。1 回の送信に複数のファイルが含まれる場合、latest_screenshot は合計 7.5 MB まで画像を含め、残りのファイル名を表示します。

手動での確認

標準入力と標準出力で、改行区切りの JSON-RPC を使用します。

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_screenshots"}}' \
  | npx -y @hostbeam/mcp

ライセンス

MIT