关于 Suprsend Mcp Server
Suprsend CLI 是用于通过命令行操作 SuprSend API 的工具,适合管理通知工作区资源与多环境配置。README 建议 AI 工具连接托管 MCP 服务,而非使用 CLI 内置的弃用服务。
主要功能
- 01管理模板、工作流和事件
- 02在工作区间同步资源
- 03生成多语言类型代码
- 04配置多账户和环境配置
适用场景
- 01查看或推送通知工作区资源
- 02在不同工作区间迁移资产
- 03从 Schema 生成类型代码
MCP 相关
README 将 CLI 的 MCP 服务标记为弃用,并建议 AI 客户端连接托管服务 https://mcp.suprsend.com/mcp。旧服务仍可用于服务令牌认证或自托管 BYOC 实例。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y suprsendSUPRSEND_SERVICE_TOKEN密钥SuprSend service token. Create one in the SuprSend dashboard under Developers → API Keys.SUPRSEND_BASE_URLBase API URL. Only set for BYOC / self-hosted SuprSend instances.SUPRSEND_MGMNT_URLManagement API URL. Only set for BYOC / self-hosted SuprSend instances.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
22收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| object_id | string | 是 | 要获取其订阅的对象的 object_id。 |
| workspace | string | 否 | 要从中获取对象的 Suprsend 工作区。 |
| properties | object | 否 | 用户/对象的属性 |
| recipients | array | 是 | 订阅对象的用户和对象 |
| object_type | string | 是 | 要获取的对象类型。 |
详细介绍
SuprSend CLI
SuprSend CLI 是一个用 Go 编写的命令行工具,可用于与 SuprSend API 交互。要将 AI Agent(Claude、Cursor、VS Code、Gemini 等)连接到 SuprSend,请使用托管的 SuprSend MCP 服务,而不是 CLI。
可以用它做什么
- 管理工作区资源 —
template、workflow、schema、event、category、translation、workspace。大多数资源都支持针对本地工作目录执行list、get、pull、push和commit(event不支持commit,category不支持get,而workspace仅支持list)。 - 在工作区之间同步 —
suprsend sync会从一个工作区拉取资源,并将其推送并提交到另一个工作区(更改会在目标工作区生效),使用本地目录(默认为./suprsend)作为中间存储。 - 生成类型化载荷代码 —
suprsend generate-types可根据事件 / 工作流 JSON Schemas 生成 Go、TypeScript、Python、Java、Kotlin、Swift 或 Dart 类型化代码。 - MCP 服务(已弃用) —
suprsend start-mcp-server仍可使用,但已弃用。请改用托管的 MCP 服务https://mcp.suprsend.com/mcp(对于 Claude Code:claude mcp add --transport http suprsend https://mcp.suprsend.com/mcp),或使用 suprsend/claude-plugin 和 suprsend/agent-plugin 插件。Gemini CLI:在~/.gemini/settings.json的mcpServers下添加"suprsend": {"httpUrl": "https://mcp.suprsend.com/mcp"},然后运行/mcp auth suprsend(Gemini CLI 扩展已停止维护)。只有在需要使用服务令牌进行身份验证或使用可自托管(BYOC)实例时,才继续使用start-mcp-server。 - 多账户 / 多环境配置文件 —
suprsend profile add|modify|list|use|remove可存储每个账户的凭据和基础 URL,因此同一 CLI 可用于公有云、BYOC、staging、pre-prod 等环境。
完整命令参考:docs.suprsend.com/reference/cli-intro。或者运行 suprsend --help 查看命令树。
安装
npm / npx
无需安装即可运行:
npx suprsend --help
或者全局安装:
npm i -g suprsend
suprsend --help
适用于 macOS、Linux 和 Windows(x64 和 arm64)。需要 Node.js ≥ 18(用于 npx)。
Homebrew
你可以使用 Homebrew 安装 SuprSend CLI:
brew tap suprsend/tap
brew install --cask suprsend
二进制发行版
你可以在 Releases 页面获取适用于各种平台的预编译二进制文件。
从源代码构建
按照以下步骤从源代码构建 SuprSend CLI:
-
确保系统已安装 Go(版本 1.27.3 或更高版本 — 请参阅
go.mod)。 -
克隆仓库:
git clone https://github.com/suprsend/cli.git cd cli/cmd/suprsend -
构建二进制文件:
go build -o suprsend -
二进制文件将在当前目录中创建。你可以将它移到 PATH 中的某个位置,以便轻松访问:
sudo mv suprsend /usr/local/bin/
现在,你可以在终端的任意位置使用 suprsend 命令。
使用方法
安装后,你可以运行 suprsend 命令来使用 CLI。例如:
suprsend --help
文档
请参阅此处的文档,或者如果你想访问 Cobra 生成的文档,请查看此处。
贡献
欢迎贡献!欢迎提交 Pull Request。
在本地生成构建产物
make build 会编译内嵌的 type-morph Deno 二进制文件(需要 Deno),然后在 docs/ 中生成 CLI 文档,并在 skills/ 中生成 AI 技能。
make build
针对提交到 main 的 PR,CI 检查会验证 docs/ 和 skills/ 是否为最新版本。打开 PR 前,请运行 make build 并提交生成的文件。这两者都由命令定义生成,因此请修改命令帮助文本,而不是生成的文件。
在 make build 之后(该命令会创建软件包编译所依赖的内嵌二进制文件),运行单元测试:
go test ./...
移除本地构建产物
make clean
许可证
本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。