smbCloud Mail & Auth

smbCloud CLI

在终端或 AI Agent 中使用 smbCloud Mail、Auth、Deploy 和 GresIQ。

网站 · 文档 · 参与贡献 · 发行版本

关于

smb 是 smbCloud 的命令行界面。它也是一个 MCP 服务，因此 Claude、Cursor 和其他 AI Agent 可以执行与你相同的操作。

通过 smbCloud Mail 发送事务性邮件并设置域名和收件箱路由，通过 smbCloud Auth 管理身份验证应用，并部署 Rust、Node.js、Ruby 或 Swift 应用。一个二进制文件，无需安装运行时。

安装

如果想要最快完成设置，请使用预构建的原生二进制文件。

Homebrew（macOS 和 Linux）

brew tap smbcloudXYZ/tap && brew trust --tap smbcloudXYZ/tap
brew install cli

npm

npm install -g @smbcloud/cli

.NET 工具

dotnet tool install --global SmbCloud.Cli

pip

pip install smbcloud-cli

Shell（macOS / Linux）

curl -fsSL https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-unix.sh | sh

PowerShell（Windows）

irm https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-windows.sh | iex

或者从 发行版本页面获取预构建的二进制文件。

快速开始

smb login
smb init
smb deploy

这样即可从登录开始完成首次部署。

MCP 服务

smb --mcp 通过 stdio 使用 Model Context Protocol，提供涵盖 smbCloud Mail、Auth、项目和部署的 31 个工具。它已列入官方 MCP Registry，标识为 io.github.smbcloudXYZ/smbcloud-cli。

Claude Code：

claude mcp add smbcloud -- smb --mcp

Claude Desktop、Cursor，以及其他接受 JSON 配置的应用：

{
  "mcpServers": {
    "smbcloud": {
      "command": "npx",
      "args": ["@smbcloud/cli", "--mcp"]
    }
  }
}

身份验证通过 smb login 完成，因此终端会话和 Agent 会话共享同一个令牌和所选项目。完整工具参考请参阅 docs/mcp.md。

如需测试移动应用和电视应用，请运行专用的 XCRS Mobile & TV Automation 配置：

claude mcp add xcrs -- smb --mcp --scope automation

它提供可感知目标的 Xcode、ControlKit、CoreDevice 和 adb 工具，不会将它们混入云工具集。此配置也可通过独立的 xcrs --mcp crate 使用。

CI / 非交互模式

传入 --ci（或设置 SMB_CI=1，或在任何设置了 CI 的提供商环境中运行），即可禁用交互式提示。确认操作将采用默认选项；任何确实需要输入的操作都会快速失败并显示清晰的错误消息，而不会因缺少 TTY 而挂起。

smb --ci deploy

例如，AircraftsHub 单体仓库通过一条非交互式命令部署其 Next.js Web 应用——其 .smb/config.toml 固定了项目、源和运行时，因此 smb --ci deploy 无需提示。令牌设置和完整行为说明请参阅 docs/ci.md。

文档

请参阅 docs/ 目录，了解身份验证、项目配置和部署工作流指南。

贡献

请阅读 CONTRIBUTING.md 以开始贡献。欢迎提交贡献。

如需了解更广泛的产品，请参阅 smbCloud 和部署文档。

许可证

Apache-2.0

版权

© 2026 Splitfire AB（smbCloud）。