ShareBox

本地服务

github.com云与基础设施301 周前更新

代码仓库访问官网

关于 ShareBox

ShareBox 是可自托管的平台和命令行工具，用于发布 AI Agent 构建的小型 Web 工具，并分享给指定人员、Google Workspace 域或链接持有者。其 MCP 接口提供发布与分享工具，还包含指南资源和构建提示词。

主要功能

01使用 SDK 初始化入门项目
02发布或更新 Web 工具
03列出工具并查看详情
04分享工具或移除分享
05回滚到先前版本
06管理外部服务密钥

适用场景

01将 Agent 构建的 Web 工具发布到 ShareBox 实例
02更新已发布工具并保留地址和数据
03向个人、域或链接受众分享工具
04将工具恢复到先前版本

MCP 相关

它通过 stdio 运行 MCP 服务，提供创建、发布、列出、分享和回滚工具的功能。它还将指南作为 MCP 资源提供，并包含 `build_tool` 提示词。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "zalaso-sharebox": {
      "command": "npx",
      "args": [
        "-y",
        "sharebox-cli"
      ],
      "env": {
        "SHAREBOX_URL": "<SHAREBOX_URL>",
        "SHAREBOX_TOKEN": "<SHAREBOX_TOKEN>"
      }
    }
  }
}

启动命令npx -y sharebox-cli

需要配置的环境变量

SHAREBOX_URLAddress of your ShareBox instance, e.g. https://sharebox.example.com (not needed after `sharebox login`)

SHAREBOX_TOKEN密钥API token for that instance (not needed after `sharebox login`)

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

安装包

npmsharebox-cli0.1.5stdio

工具

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

此工具无需参数。

详细介绍

sharebox-cli

ShareBox 的命令行工具和 MCP 服务。ShareBox 是一个可自托管平台，AI Agent 可以在其中发布小型 Web 工具，并像分享 Google 文档一样与特定人员、整个 Google Workspace 网域或任何持有链接的人分享。访客通过 Google 登录；每个工具都有可信身份、专属存储和独立沙箱。

你需要一个正在运行的 ShareBox 实例（可以是自己的，也可以是组织的）。如需设置，请参阅安装指南。

安装

npm install -g sharebox-cli

需要 Node 20 或更新版本。每个 ShareBox 实例也会在 https://<instance>/cli/sharebox.tgz 提供自己的副本。

连接

sharebox login sharebox.example.com

浏览器会打开：使用 Google 登录并点击 Authorize。令牌会存储在 ~/.sharebox/credentials.json 中。在服务器或 CI 环境中，你也可以改为设置 SHAREBOX_URL 和 SHAREBOX_TOKEN。

在 Agent 中使用（MCP）

Claude Code：

claude mcp add --scope user sharebox -- sharebox mcp

在 Windows 上：claude mcp add --scope user sharebox -- cmd /c sharebox mcp。

如果未进行全局安装，其他 MCP 客户端可以运行 npx -y sharebox-cli mcp（先运行一次 npx sharebox-cli login <instance>）。

工具：sharebox_guide、sharebox_create_project、sharebox_publish、sharebox_list、sharebox_info、sharebox_share、sharebox_rollback、sharebox_unshare。这里特意不提供删除工具：删除会清除数据，因此该操作仅在 CLI 中提供，并要求确认。

指南也作为 MCP 资源提供（sharebox://guide）；build_tool 提示词（参数为 idea 和可选的 share_with）会要求 Agent 构建、发布工具，并可选择根据附带的指南分享工具。在 Claude Code 中，它会显示为 /mcp__sharebox__build_tool。

然后只需提出需求："为我的团队构建一个假期追踪工具，并发布到 ShareBox 上。"

命令

命令	功能
`sharebox init <folder> [--name N]`	创建包含 SDK 使用示例的起始文件夹
`sharebox publish [folder] [--name N] [--tool T]`	发布工具，或在后续运行时更新同一工具（地址不变，数据保留）。`--tool` 可从任意文件夹更新现有工具，例如在 Agent 于其他位置重建工具后使用
`sharebox list`	你可以管理的工具
`sharebox info <tool>`	地址、版本和分享对象
`sharebox share <tool> <with> [--role use\|manage]`	`<with>`：电子邮件地址、`@domain.com` 或 `anyone`
`sharebox unshare <tool> <with>`	移除分享
`sharebox secret set <tool> <NAME> --host <domain>`	为外部服务设置密钥，输入时不会回显（也可通过 stdin 管道输入）；工具在向该网域发送请求时使用 `{{secret:NAME}}`
`sharebox secret list <tool>` · `sharebox secret remove <tool> <NAME>`	密钥名称和网域（绝不显示密钥值）· 移除一个密钥
`sharebox rollback <tool>`	回退到上一版本（以新版本重新发布，链接和数据不变）；再次运行即可撤销回退
`sharebox delete <tool> --yes`	删除工具及其数据
`sharebox guide`	如何构建工具（面向 Agent 编写）
`sharebox mcp`	通过 stdio 运行 MCP 服务