mcpField
S
Suprsend Mcp Server

Suprsend Mcp Server

本地服务
suprsend.com开发工具125 天前更新

关于 Suprsend Mcp Server

Suprsend CLI 是用于通过命令行操作 SuprSend API 的工具,适合管理通知工作区资源与多环境配置。README 建议 AI 工具连接托管 MCP 服务,而非使用 CLI 内置的弃用服务。

主要功能

  1. 01管理模板、工作流和事件
  2. 02在工作区间同步资源
  3. 03生成多语言类型代码
  4. 04配置多账户和环境配置

适用场景

  1. 01查看或推送通知工作区资源
  2. 02在不同工作区间迁移资产
  3. 03从 Schema 生成类型代码

MCP 相关

README 将 CLI 的 MCP 服务标记为弃用,并建议 AI 客户端连接托管服务 https://mcp.suprsend.com/mcp。旧服务仍可用于服务令牌认证或自托管 BYOC 实例。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"cli-suprsend": {
"command": "npx",
"args": [
"-y",
"suprsend"
],
"env": {
"SUPRSEND_SERVICE_TOKEN": "<SUPRSEND_SERVICE_TOKEN>",
"SUPRSEND_BASE_URL": "<SUPRSEND_BASE_URL>",
"SUPRSEND_MGMNT_URL": "<SUPRSEND_MGMNT_URL>"
}
}
}
}
启动命令npx -y suprsend
需要配置的环境变量
SUPRSEND_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+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmsuprsend1.0.1

工具

22

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

参数类型必填说明
object_idstring是要获取其订阅的对象的 object_id。
workspacestring否要从中获取对象的 Suprsend 工作区。
propertiesobject否用户/对象的属性
recipientsarray是订阅对象的用户和对象
object_typestring是要获取的对象类型。

详细介绍

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:

  1. 确保系统已安装 Go(版本 1.27.3 或更高版本 — 请参阅 go.mod)。

  2. 克隆仓库:

    git clone https://github.com/suprsend/cli.git
    cd cli/cmd/suprsend
    
  3. 构建二进制文件:

    go build -o suprsend
    
  4. 二进制文件将在当前目录中创建。你可以将它移到 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 文件。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。