星战科技xingzhan.cloud
返回市场
滑动MCP

滑动MCP

作者：amcchord2 星标更新：2025-10-17
安装使用来源：spider==github.com

项目介绍

Slide MCP Server

一个与Slide API集成的MCP服务器实现，通过精简的元工具架构提供全面的设备和基础设施管理功能。

🚀 Go二进制实现 ⚡

  • 单个二进制文件：无需依赖项，下载后即可运行
  • 快速启动：初始上下文加载时启动时间约为50毫秒
  • 低内存使用：内存占用10-20MB
  • 跨平台：适用于Linux、macOS和Windows的二进制文件
  • 零安装烦恼：简单下载并配置
  • 简洁接口：13个元工具代替了52+个独立工具，以更好地与LLM交互
  • 增强性能：初始上下文加载消除了首次API调用延迟

对于如何快速设置Claude Desktop，请参阅下面的安装部分。

🎯 主要架构改进

元工具设计：此MCP服务器采用创新的元工具架构，将52+个独立API操作整合为仅13个专注的元工具。这种设计显著降低了LLM的复杂性，同时保持了全部功能。

每个元工具接受一个operation参数，该参数指定了要执行的操作以及该操作的相关参数。

示例使用模式

{
  "name": "slide_devices",
  "arguments": {
    "operation": "list",
    "limit": 10,
    "client_id": "client-123"
  }
}

可用的元工具

🔧 核心基础设施

  1. slide_devices - 物理设备管理

    • 操作：list, get, update, poweroff, reboot
    • 功率控制、主机名/显示名称更新、客户端分配

  2. slide_agents - 备份代理管理

    • 操作：list, get, create, pair, update
    • 代理创建、与设备配对、显示名称管理

  3. slide_networks - 网络基础设施

    • 操作：list, get, create, update, delete
    • 创建支持DHCP和VPN的网络，客户端隔离
    • IPSec：create_ipsec, update_ipsec, delete_ipsec
    • 端口转发：create_port_forward, update_port_forward, delete_port_forward
    • WireGuard VPN：create_wg_peer, update_wg_peer, delete_wg_peer

💾 数据管理

  1. slide_backups - 备份操作

    • 操作：list, get, start
    • 启动并监控备份作业

  2. slide_snapshots - 快照管理

    • 操作：list, get
    • 浏览并访问点对时间快照，带有高级过滤器

  3. slide_restores - 文件及镜像恢复

    • 文件恢复：list_files, get_file, create_file, delete_file, browse_file
    • 推送恢复：list_pushes, create_push, update_push - 直接恢复文件到受保护系统（目标必须是X:\SlideRestore）
    • 镜像导出：list_images, get_image, create_image, delete_image, browse_image
    • 支持VHD、VHDX（动态/固定）和原始磁盘格式
    • 可选引导修改（无密码管理员用户）

☁️ 虚拟基础设施

  1. slide_vms - 虚拟机管理
    • 操作：list, get, create, update, delete, get_rdp_bookmark
    • 基于浏览器的VNC控制台访问和可下载的RDP书签
    • 配置CPU（1-16核）和RAM（1-12GB）
    • 多种网络模式和磁盘总线类型

👥 管理

  1. slide_user_management - 用户和账户管理

    • 用户：list_users, get_user - 用户账户信息和权限
    • 账户：list_accounts, get_account, update_account - 账户设置和警报邮件配置
    • 客户端：list_clients, get_client, create_client, update_client, delete_client - 客户端组织和资源管理

  2. slide_alerts - 警报监控

    • 操作：list, get, update（解决）
    • 系统警报管理和解决

📊 数据展示与报告

  1. slide_presentation - 专业数据格式化和文档

    • 操作：get_card, get_runbook_template, get_daily_report_template, get_monthly_report_template
    • 卡片类型：单独项目卡片（代理、客户端、设备、快照）和表格卡片（agents_table, clients_table等）
    • 报告模板：运行手册程序、每日活动摘要、月度分析报告
    • 格式：支持HTML、Markdown、HAML多种输出需求
    • 适合状态显示、仪表板、文档和专业报告
    • ⚠️ 默认禁用：必须显式启用--enable-presentation标志或SLIDE_ENABLE_PRESENTATION=true ⚠️ 重要：如果您正在构建自己的呈现逻辑或自定义格式，您可能希望禁用slide_presentation工具以避免与您的自定义实现冲突。要仅禁用slide_presentation工具，请将其添加到DISABLED_TOOLS环境变量或在CLI中的--disabled-tools部分

  2. slide_meta - 报告和聚合数据视图的元工具

    • 操作：list_all_clients_devices_and_agents, get_snapshot_changes, get_reporting_data
    • list_all_clients_devices_and_agents：完整的分层基础设施视图
    • get_snapshot_changes：跟踪一段时间内的新删除快照（天、周、月）
    • get_reporting_data：预格式化的数据填充报告模板
    • 适合生成具有准确预计算指标的报告

  3. slide_reports - 备份/快照分析的预计算统计和报告

    • ⚠️ 默认禁用：必须显式启用--enable-reports标志或SLIDE_ENABLE_REPORTS=true
    • 操作：daily_backup_snapshot, weekly_backup_snapshot, monthly_backup_snapshot
    • 每日报告：单日统计数据，包括备份成功率和失败原因
    • 每周报告：7天细分，包含每日代理计数和成功指标
    • 每月报告：整月分析，带有可视日历视图（Markdown格式）
    • 过滤：按agent_id、device_id或client_id进行有针对性的报告
    • 格式：JSON（结构化数据）或Markdown（人类可读）
    • 性能：使用详细模式来跟踪大型报告的进度

  4. slide_docs - 访问官方Slide文档

    • 操作：list_sections, get_topics, search_docs, get_content, get_api_reference
    • 文档访问：直接浏览和搜索docs.slide.tech内容
    • 上下文帮助：获取最佳实践、故障排除指南和功能解释
    • API参考：快速访问API端点文档
    • 集成：通过提供上下文和指导来补充其他工具

🔍 特殊工具

  • list_all_clients_devices_and_agents - 分层概述（现在是slide_meta的一部分）
    • 一次调用即可获得所有客户端及其设备和代理的完整视图
    • 适合回答有关基础设施规模和组织的问题
    • 可以直接调用或通过slide_meta使用操作list_all_clients_devices_and_agents

关键特性

🔐 基础设施管理

  • 设备控制：远程电源操作、主机名管理、客户端分配
  • 代理部署：自动配对、显示名称管理
  • 网络隔离：客户端特定网络，带VPN访问
  • 高级网络：IPSec隧道、端口转发、WireGuard对等方

💽 数据保护与恢复

  • 自动化备份：基于代理的备份启动和监控
  • 点对时间恢复：带有位置过滤的快照浏览
  • 灵活恢复：文件级和全磁盘镜像导出
  • 多种格式：VHD、VHDX（动态/固定）、原始磁盘镜像
  • 引导修改：可选创建无密码管理员账户

☁️ 虚拟化

  • 虚拟机创建：从任何快照创建虚拟机
  • 资源控制：可配置CPU/RAM分配
  • 网络集成：连接虚拟机到隔离网络
  • 控制台访问：基于浏览器的VNC直接与虚拟机交互
  • RDP书签：生成可下载的.rdp文件，方便Windows远程桌面访问

📊 监控与组织

  • 警报管理：集中警报监控和解决
  • 客户端组织：按客户端分组资源，便于管理
  • 用户管理：账户访问和权限
  • 综合过滤：所有资源的高级分页和排序

📋 专业数据展示

  • 智能卡片：代理、客户端、设备和快照的单独和表格卡片
  • 报告模板：运行手册程序、每日摘要和月度分析报告
  • 多种格式：HTML、Markdown和HAML输出，适用于不同场景
  • 仪表板准备：预格式化的卡片非常适合状态显示和监控
  • 文档支持：用于操作程序和故障排除的专业模板

所有元工具都支持分页（limit, offset）和排序选项，适用时。

📊 数据展示工具指南

**slide_presentation**工具是您进行专业数据格式化和文档的主要资源。它提供了预建模板和智能卡片，将原始数据转换为精致、易读的格式。

🎯 何时使用呈现工具

始终首先考虑此工具，当您需要：

  • 向用户显示系统状态或监控数据
  • 显示项目列表（代理、客户端、设备、快照）
  • 在结构化格式中呈现单独项目的详细信息
  • 创建报告或摘要
  • 生成文档或程序
  • 格式化任何可以从专业呈现中受益的数据

📋 报告模板

完美用于全面文档和分析：

运行手册模板（get_runbook_template）

  • 目的：操作程序、故障排除指南、逐步说明
  • 使用案例：事件响应、维护程序、故障排除指南
  • 格式：HTML、Markdown、HAML

每日报告模板（get_daily_report_template）

  • 目的：活动摘要、状态更新、每日报告
  • 使用案例：每日操作摘要、状态简报、活动追踪
  • 格式：HTML（默认）、Markdown、HAML

月度报告模板（get_monthly_report_template）

  • 目的：全面分析、趋势、月度总结
  • 使用案例：执行摘要、趋势分析、绩效审查
  • 格式：HTML（默认）、Markdown、HAML

📊 智能卡片

完美用于状态显示、仪表板和数据可视化：

单一项目卡片 - 详细视图

  • agent：带有主机名、操作系统、状态和最近备份的单独备份代理
  • client：带有名称、代理数量、设备分配和统计信息的单独客户端
  • device：带有容量、分配和存储信息的单独备份设备
  • snapshot：带有日期、大小、状态和保留期的单独备份快照

表格卡片 - 概览仪表板

  • agents_table：多个代理比较，带有状态概览和分配
  • clients_table：多个客户端摘要，带有代理数量和状态
  • devices_table：多个设备概述，带有容量和利用率
  • snapshots_table：按时间顺序排列的备份历史记录，带有大小和状态

💡 决策指南

根据您的需求选择正确的呈现格式：

需求推荐示例
显示一个项目的详细信息单一项目卡片agent, client, device, snapshot
显示多个项目的概览表格卡片agents_table, clients_table, devices_table
创建文档报告模板get_runbook_template
生成状态报告日/月模板get_daily_report_template
仪表板显示表格卡片agents_table, devices_table
故障排除指南运行手册模板get_runbook_template

🚀 最佳实践

  1. 从呈现开始：始终考虑在显示原始数据之前使用呈现工具
  2. 选择正确的卡片：使用单一卡片显示细节，表格卡片显示概览
  3. 格式化目的：使用HTML用于网页显示，Markdown用于文档
  4. 专业输出：让工具处理格式化，而不是手动格式化
  5. 一致体验：使用卡片在整个数据显示中保持一致的外观和感觉

📦 安装与配置

获取API密钥

  1. 登录到您的Slide账户
  2. 导航到您的账户设置
  3. 从API部分生成您的API密钥

🎯 使用Claude Desktop快速设置

🖥️ GUI安装程序（推荐）

为了最简单的安装体验，使用我们的跨平台GUI安装程序，具有原生桌面集成：

macOS

  1. 下载安装程序：从最新发布

    • Apple Silicon (M1/M2/M3/M4)：slide-mcp-installer-v2.3.2-darwin-arm64-signed.tar.gz
    • Intel Mac：slide-mcp-installer-v2.3.2-darwin-amd64-signed.tar.gz

  2. 解压并运行：

    tar -xzf slide-mcp-installer-v2.3.2-darwin-[arch]-signed.tar.gz
open slide-mcp-installer.app

  3. 输入您的API密钥：当提示时输入您的Slide API密钥

  4. 安装：点击“安装Slide MCP服务器”

  5. 重启Claude Desktop：安装程序会自动配置一切

Windows

  1. 下载安装程序：从最新发布

    • 64位：slide-mcp-installer-v2.3.2-windows-amd64.zip

  2. 解压并运行：

    • 解压ZIP文件
    • 运行slide-mcp-installer.exe

  3. 输入您的API密钥：当提示时输入您的Slide API密钥

  4. 安装：点击“安装Slide MCP服务器”

  5. 重启Claude Desktop：安装程序会自动配置一切

GUI安装程序提供：

  • ✅ 智能检测：自动检测Claude Desktop安装和现有配置
  • ✅ 原生集成：macOS上的正确.app捆绑包，支持图标，没有终端窗口
  • ✅ 自动下载：为您的平台获取最新的slide-mcp-server二进制文件
  • ✅ 智能安装：安装到正确的位置，并具有适当的权限
  • ✅ 配置管理：无缝更新Claude Desktop配置
  • ✅ API密钥管理：显示当前API密钥状态并允许轻松更新
  • ✅ 进度跟踪：安装期间的视觉进度条和状态更新
  • ✅ 干净卸载：需要时完全移除服务器和配置
  • ✅ 跨平台：适用于Windows、macOS（Intel和Apple Silicon）和Linux

手动安装

下载预构建的二进制文件（v2.3.2）

对于macOS ARM64（Apple Silicon）：

curl -L -o slide-mcp-server-v2.3.2-macos-arm64.tar.gz https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-macos-arm64.tar.gz
tar -xzf slide-mcp-server-v2.3.2-macos-arm64.tar.gz
chmod +x slide-mcp-server-v2.3.2-macos-arm64
mv slide-mcp-server-v2.3.2-macos-arm64 slide-mcp-server

对于macOS x64：

curl -L -o slide-mcp-server-v2.3.2-macos-x64.tar.gz https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-macos-x64.tar.gz
tar -xzf slide-mcp-server-v2.3.2-macos-x64.tar.gz
chmod +x slide-mcp-server-v2.3.2-macos-x64
mv slide-mcp-server-v2.3.2-macos-x64 slide-mcp-server

对于Linux x64：

curl -L -o slide-mcp-server-v2.3.2-linux-x64.tar.gz https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-linux-x64.tar.gz
tar -xzf slide-mcp-server-v2.3.2-linux-x64.tar.gz
chmod +x slide-mcp-server-v2.3.2-linux-x64
mv slide-mcp-server-v2.3.2-linux-x64 slide-mcp