Hostbeam

Name: Hostbeam
Author: hostbeam.app

本地服务

hostbeam.app开发工具03 周前更新

代码仓库访问官网

关于 Hostbeam

Hostbeam 是供远程服务器上运行的编码 Agent 使用的 MCP 服务。它可读取通过 SSH 从 Mac 或 iPhone 发送的截图，无需将截图路径粘贴给 Agent。

主要功能

01获取最新发送的截图
02列出近期截图及其信息
03按文件名读取截图
04仅读取已发送的图片文件
05拒绝不安全目录和符号链接

适用场景

01在远程编码会话中检查手机截图
02无需粘贴路径即可向 Agent 提供截图
03读取前查看近期发送的文件

MCP 相关

该服务与编码 Agent 运行在同一服务器上，提供获取、列出和读取 Hostbeam 传送截图的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "app-hostbeam": {
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ],
      "env": {
        "HOSTBEAM_DIR": "<HOSTBEAM_DIR>"
      }
    }
  }
}

启动命令npx -y @hostbeam/mcp

需要配置的环境变量

HOSTBEAM_DIRThe folder Hostbeam beams to on this server. Leave unset for /tmp/hostbeam.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@hostbeam/mcp0.1.4stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Hostbeam MCP 服务

Hostbeam 会通过 SSH 将 Mac 或 iPhone 上的屏幕截图发送到服务端，并将远程路径放入剪贴板，这样你就可以将路径粘贴给在服务端运行的编码 Agent。

这个 MCP 服务运行在该服务端上，与 Agent 并列。Agent 可以请求并读取你刚刚传送的屏幕截图，无需你粘贴路径。

安装

请在运行 Agent 的服务端上安装，而不是在 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 返回最近传送的屏幕截图，并显示它到达的时间。如果你一次传送了多个文件，它会返回所有文件，最多六个，并列出其余文件的名称。
list_screenshots 列出最近传送的文件，包含文件名、大小和时间。不包含图像数据。
read_screenshot 按名称返回一个文件。

可读取的内容

只读取由 Hostbeam 传送的文件：位于指定文件夹中、文件名以 hostbeam- 开头且扩展名为图像格式的文件。它不会查看子文件夹，也会拒绝包含路径的名称。它绝不会写入、移动或删除任何内容。

它会跳过符号链接，也不会读取属于其他用户或任何用户都可写入的文件夹，因为其中的文件可能并非由你传送。

JPEG、PNG、GIF 和 WebP 文件会以图像形式返回，每个文件最大为 3.75 MB。其他格式和更大的文件会以路径形式返回：模型只接受这四种格式，模型 API 也会拒绝较大的图像。如果一次传送中包含多个文件，latest_screenshot 会返回总大小不超过 7.5 MB 的图像，并列出其余文件的名称。

手动检查

它通过 stdin 和 stdout 使用以换行符分隔的 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