AI导哈

备份恢复服务器

Slide MCP Server 是一个连接AI助手与Slide BCDR API的Go二进制工具，提供备份健康检查、文件恢复、快照管理、警报处理、恢复虚拟机、镜像导出、灾难恢复网络和账户管理等功能。

  • by amcchord
  • Go
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 amcchord/slideMCP

使用说明

幻灯片MCP服务器

slide-mcp-server 将AI助手连接到 幻灯片BCDR API。它是一个单一的Go二进制文件，带有面向任务的工具，用于备份健康、文件恢复、快照、警报、恢复VM、映像导出、灾难恢复网络和帐户管理。

它支持两个主要的当地MCP生态系统：

  • Anthropic：拖放克劳德桌面MCP捆绑包和克劳德代码注册。
  • OpenAI：通过共享的MCP配置进行Codex桌面、CLI和IDE注册。

服务器使用stdio JSON-RPC，没有运行时依赖关系，并且从不将Slide API令牌写入此存储库。

安装

克劳德桌面：拖放

  1. 下载 slide-mcp-server.mcpb.
  2. 将其拖入 Claude 桌面版→ 设置→ 扩展.
  3. 从粘贴幻灯片API令牌 console.slide.tech 在...之下 我的设置→ API令牌.

该捆绑包包含macOS通用、Linux amd64/arm64和Windows amd64二进制文件。它的macOS二进制文件是由苹果公司签名和公证的开发者ID，因此正常的在线网守检查会在没有警告的情况下运行。

稳定的下载URL始终指向最新的GitHub版本。退役的MCPB前安装程序也在继续工作：版本发布了其历史记录 macos-x64, macos-arm64, linux-x64, linux-arm64，以及 windows-x64 资产名称。

私有的、侧面加载的Claude Desktop捆绑包目前不会自动更新。重新安装马厩 .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 代码

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

游标和其他stdio MCP主机

下载适用于您平台的二进制文件，并配置以下等效内容：

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

问什么

  • “我所有的幻灯片盒都健康吗？”
  • “昨晚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 恢复虚拟机、映像导出和灾难恢复网络
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模式验证；
  • --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仅适用于本地主机测试服务器。

测试线束

存储库有三个测试层：

# 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 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. 开发者ID对通用macOS可执行文件进行签名和公证；
  5. 打包并验证 .mcpb;
  6. 构建当前和旧版安装程序资产名称以及SHA-256校验和；
  7. 在标记之前再次强制签署/公证；
  8. 推 main，创建标签，并发布GitHub版本。

苹果公司无法将票钉到原始Mach-O可执行文件上。 stapled: no 预期； codesign --test-requirement="=notarized" 执行正确的在线公证检查。

许可证

麻省理工学院

相关 MCP