Slide MCP Server

Slide MCP 服务

slide-mcp-server 将 AI 助手连接到 Slide BCDR API。它是一个 Go 单文件二进制程序，提供面向任务的工具，用于备份健康状况、文件恢复、快照、警报、恢复 VM、映像导出、DR 网络和账户管理。

它支持两大本地 MCP 生态系统：

• Anthropic：可拖放的 Claude Desktop MCP Bundle，以及 Claude Code 注册。
• OpenAI：通过共享 MCP 配置注册 Codex 桌面应用、CLI 和 IDE。

该服务使用 stdio JSON-RPC，没有运行时依赖，并且绝不会将 Slide API 令牌写入此代码库。

安装

Claude Desktop：拖放安装

1. 下载 slide-mcp-server.mcpb。
2. 将其拖入 Claude Desktop → Settings → Extensions。
3. 在 My Settings → API Tokens 下粘贴来自 console.slide.tech 的 Slide API 令牌。

该 Bundle 包含 macOS universal、Linux amd64/arm64 和 Windows amd64 二进制文件。其 macOS 二进制文件已通过 Developer ID 签名，并经 Apple 公证，因此在线正常运行 Gatekeeper 检查时不会出现警告。

稳定下载 URL 始终指向最新的 GitHub 版本。已停用的旧版 MCPB 安装程序也仍可使用：各版本会发布历史资产名称 macos-x64、macos-arm64、linux-x64、linux-arm64 和 windows-x64。

目前，私有的侧载 Claude Desktop Bundle 不会自动更新。扩展为私有状态时，重新安装稳定版 .mcpb 即可更新。Anthropic 为通过其官方目录分发的扩展启用自动更新；清单已为该提交流程做好准备。请参阅 Anthropic 的本地扩展指南。

OpenAI Codex

从克隆开始：

make build
SLIDE_API_KEY=tk_... make install-codex
codex mcp get slide

也可以直接注册任何已下载的二进制文件：

codex mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server

Codex 桌面应用、CLI 和 IDE 使用共享的 MCP 配置。重新运行 make install-codex 会安全地替换现有的 slide 注册项。

Claude Code

make build
SLIDE_API_KEY=tk_... make install-claude-code
claude mcp list

也可以直接注册：

claude mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server

Cursor 和其他 stdio MCP 宿主

下载适用于你平台的二进制文件，并配置相应的内容：

{
  "mcpServers": {
    "slide": {
      "command": "/absolute/path/to/slide-mcp-server",
      "env": {
        "SLIDE_API_KEY": "tk_...",
        "SLIDE_TOOLS": "safe"
      }
    }
  }
}

可以询问什么

• “我的 Slide 设备都正常吗？”
• “ACME 昨晚运行备份了吗？”
• “在 Bob 的笔记本电脑上查找 Q4-budget.xlsx，并恢复星期二的版本。”
• “我有哪些未解决的警报？按严重程度从高到低排序。”
• “启动 DC-01 的恢复 VM。”
• “过去 24 小时内有什么变化？”
• “我不知道从哪里开始——你能做什么？”

你无需记住 a_...、d_... 或 c_... 标识符。面向用户的操作接受 name_hint；服务端会进行确定性匹配来解析显示名称和主机名，或者在名称不明确时返回候选项。

MCP 接口

该服务提供 12 个面向任务的工具，以及一个兼容性别名。每个主工具都使用 operation 参数，而不是为每个 API 端点分别创建一个顶层工具。

工具	用途
slide_help	内置入门指南、示例、术语表、故障排查和诊断
slide_overview	完整清单、健康状况以及客户端／设备摘要
slide_files	搜索、浏览、还原和推送文件
slide_recovery	恢复 VM、映像导出和 DR 网络
slide_audit	账户审计日志查询
slide_clients	客户端管理
slide_admin	用户和账户管理
slide_devices	设备详情、网络和设备操作
slide_agents	受保护系统的设置、服务、计划和保留策略
slide_snapshots	还原点和验证结果
slide_backups	备份状态和启动备份
slide_alerts	告警审查、分类和解决
list_all_clients_devices_and_agents	向后兼容的清单别名

它还提供六个 MCP 提示词，包括 slide.welcome、slide.daily-status 和 slide.restore-file，以及静态／动态 slide:// 资源。

安全性和可靠性

默认的 safe 权限级别允许执行恢复操作，但会阻止删除、关机和重启。可用模式如下：

模式	允许的操作
read-only	列出、获取、搜索、浏览和诊断操作
safe	读取操作，以及还原、备份和可逆设置
full	所有操作，包括删除和电源循环操作

仍接受旧名称 reporting、restores 和 full-safe，以确保现有配置能够继续启动。

可靠性保护措施包括：

• 启动验证不会阻塞 MCP 初始化握手；
• 操作期限为 45 秒，并限制上游响应正文大小；
• 仅对幂等读取操作进行重试／退避，避免重复修改；
• 对账户范围的清单和健康状况进行完整且可防循环的分页；
• 提供经过类型化且已隐藏令牌的 API 错误，并附带可执行的修复建议；
• 对输入和结构化输出进行服务端 JSON Schema 验证；
• 提供 --doctor 和会隐藏密钥的 --debug 诊断。

配置

CLI 标志优先于环境变量。

标志	环境变量	默认值
--api-key	SLIDE_API_KEY	正常运行必需
--base-url	SLIDE_BASE_URL	https://api.slide.tech
--tools	SLIDE_TOOLS	safe
--disabled-tools	SLIDE_DISABLED_TOOLS	无
--doctor	—	运行检查并退出
--debug	—	打印已隐藏敏感信息的诊断包并退出
--skip-startup-validation	—	跳过后台账户探测
--tool / --args	—	无需 MCP 主机即可执行一次工具调用
--version	—	打印版本并退出

非回环 API 基础 URL 必须使用 HTTPS。纯 HTTP 仅适用于 localhost 测试服务。

测试框架

该代码库有三个测试层：

# Deterministic offline suite: API failure injection, permissions, schemas,
# MCP protocol profiles, distribution contracts, and a real stdio subprocess.
make test

# Live, read-only demo/account smoke. Loads ignored .env when present and
# always rebuilds the repository binary before testing.
./smoke_test.sh

# Cross-platform binaries, MCPB structure, checksums, compatibility aliases.
make release

CI 会运行启用竞态检测的 Go 测试、go vet、交叉编译、ShellCheck、发布资源验证，以及官方 Anthropic MCPB 清单验证器。协议配置覆盖 Claude Desktop 已采用的 2025-06-18 路径，以及 Codex／当前 MCP 的 2025-11-25 路径。

如需交互式检查：

SLIDE_API_KEY=tk_... npx @modelcontextprotocol/inspector ./build/slide-mcp-server

开发

git clone https://github.com/amcchord/slideMCP.git
cd slideMCP
make setup-dev
make test
make build

API 客户端跟踪 Slide API v1.27.0；缓存的 OpenAPI 文档位于 docs/openapi.json。除非某个工作流更适合用 MCP 提示词或资源表示，否则请将新端点行为作为操作添加到最接近的现有元工具中。

实用诊断：

SLIDE_API_KEY=tk_... build/slide-mcp-server --doctor
build/slide-mcp-server --debug | jq .

发布

操作签名流水线前，请先阅读 docs/SIGNING.md。生产版本有意从已提交且干净的 main 分支切出：

./scripts/setup-signing.sh       # first machine only
make doctor-signing
./scripts/release-all-in-one.sh vX.Y.Z

发布流水线：

1. 验证 Makefile、config.go 和 dxt/manifest.json 中的版本一致；
2. 运行竞态测试和 go vet；
3. 从干净的 build/ 目录构建所有目标；
4. 对通用 macOS 可执行文件进行 Developer ID 签名和公证；
5. 打包并验证 .mcpb；
6. 构建当前和旧版安装程序资源名称，以及 SHA-256 校验和；
7. 在打标签前再次强制执行签名和公证；
8. 推送 main、创建标签并发布 GitHub 版本。

Apple 无法为原始 Mach-O 可执行文件附加公证票据。stapled: no 属于预期结果；codesign --test-requirement="=notarized" 会执行正确的在线公证检查。

许可证

MIT