npm @smbcloud/clistdioupdated 14d ago
smbCloud Mail, Auth, Deploy, and GresIQ from your terminal or your AI agent.
smbCloud Mail & Auth 能做什么?
About
smb is the command-line interface for smbCloud. It is
also an MCP server, so Claude, Cursor, and other AI agents can run the same operations
you do.
Send transactional email and set up domains and inbox routing on smbCloud Mail, manage authentication apps on smbCloud Auth, and deploy Rust, Node.js, Ruby, or Swift apps. One binary, no runtime to install.
Install
If you want the quickest setup, use a pre-built native binary.
Homebrew (macOS & Linux)
brew tap smbcloudXYZ/tap && brew trust --tap smbcloudXYZ/tap
brew install cli
npm
npm install -g @smbcloud/cli
.NET tool
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
Or grab a pre-built binary from the Releases page.
Quick Start
smb login
smb init
smb deploy
That gets you from login to first deploy.
MCP server
smb --mcp speaks the Model Context Protocol over
stdio, exposing 31 tools across smbCloud Mail, Auth, projects, and deployments. It is
listed in the official MCP Registry as io.github.smbcloudXYZ/smbcloud-cli.
Claude Code:
claude mcp add smbcloud -- smb --mcp
Claude Desktop, Cursor, and anything else that takes a JSON config:
{
"mcpServers": {
"smbcloud": {
"command": "npx",
"args": ["@smbcloud/cli", "--mcp"]
}
}
}
Auth comes from smb login, so a terminal session and an agent session share the same
token and the same selected project. See docs/mcp.md for the full tool
reference.
For mobile and TV app testing, run the focused XCRS Mobile & TV Automation profile:
claude mcp add xcrs -- smb --mcp --scope automation
It exposes target-aware Xcode, ControlKit, CoreDevice, and adb tools without
mixing them into the cloud tool set. The same profile is also available from
the standalone xcrs --mcp crate.
CI / non-interactive mode
Pass --ci (or set SMB_CI=1, or run under any provider that sets CI) to
disable interactive prompts. Confirmations take their default; anything that
truly needs input fails fast with a clear message instead of hanging on a
missing TTY.
smb --ci deploy
For example, the AircraftsHub monorepo deploys
its Next.js web app with a single non-interactive command — its
.smb/config.toml pins the project, source, and runtime, so smb --ci deploy
needs no prompts. See docs/ci.md for token setup and the full
behavior reference.
Documentation
See the docs/ directory for guides on authentication, project configuration, and deployment workflows.
Contributing
Read CONTRIBUTING.md to get started. Contributions are welcome.
For the broader product, see smbCloud and the deployment docs.
License
Copyright
© 2026 Splitfire AB (smbCloud).
安装
把 smbCloud Mail & Auth 添加到你的客户端。选择你正在使用的那个。
claude mcp add cli -- npx -y @smbcloud/clicodex mcp add cli -- npx -y @smbcloud/cliamp mcp add cli -- npx -y @smbcloud/cli{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"cli","command":"npx","args":["-y","@smbcloud/cli"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"cli": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"cli": {
"command": {
"path": "npx",
"args": [
"-y",
"@smbcloud/cli"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @smbcloud/cliRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
评分
39 / 100
不完整
- 文档25/25
- 维护25/25
- 可信度9/20
- 能力0/15
- 安装体验12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 6 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 0.5.2最新 | 2026年8月17日 |
| 0.5.1 | 2026年8月9日 |
| 0.5.0 | 2026年8月2日 |
| 0.4.13 | 2026年7月22日 |