mcpField
M
MSP360

MSP360

本地服务
github.com文件与存储06 天前更新
代码仓库访问官网

关于 MSP360

MSP360 是面向 Managed Backup Service 的 MCP 服务，用于管理和监控 MSP 备份环境，涵盖公司、计算机、备份计划、运行状态与许可证，并可启动或停止备份任务。

主要功能

  1. 01列出并查询公司
  2. 02浏览受管计算机
  3. 03查看计划与运行历史
  4. 04启动或停止备份任务
  5. 05检查监控状态与许可证

适用场景

  1. 01检查各端点的备份健康状况
  2. 02查看备份计划运行历史
  3. 03启动或停止备份任务

MCP 相关

将 MSP360 Managed Backup Service API 操作作为 MCP 工具提供给 AI 助手和 WYRE Conduit 网关。支持 stdio 和 HTTP 传输。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "wyre-ai-msp360": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MSP360_USERNAME",
        "-e",
        "MSP360_PASSWORD",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "AUTH_MODE",
        "-e",
        "LOG_LEVEL",
        "ghcr.io/wyre-ai/msp360-mcp:v1.0.1"
      ],
      "env": {
        "MSP360_USERNAME": "<MSP360_USERNAME>",
        "MSP360_PASSWORD": "<MSP360_PASSWORD>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "AUTH_MODE": "<AUTH_MODE>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}
启动命令docker run -i --rm -e MSP360_USERNAME -e MSP360_PASSWORD -e MCP_TRANSPORT -e AUTH_MODE -e LOG_LEVEL ghcr.io/wyre-ai/msp360-mcp:v1.0.1
需要配置的环境变量
MSP360_USERNAMEMSP360 Managed Backup Service provider-portal username
MSP360_PASSWORD密钥MSP360 Managed Backup Service provider-portal password
MCP_TRANSPORTTransport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
AUTH_MODE密钥Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.
LOG_LEVELLog verbosity: debug, info, warn, error

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/wyre-ai/msp360-mcp:v1.0.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MSP360 MCP 服务

适用于 MSP360 Managed Backup Service API（前身为 CloudBerry Lab）的 MCP 服务，可供 AI 助手和 WYRE Conduit 网关使用，支持管理公司、受管计算机、备份计划、监控和许可证。

身份验证

提供 Managed Backup Service 提供商门户的 UserName/Password 对。此服务通过 POST /api/Provider/Login 将其兑换为短期有效的 bearer token 并缓存；每当供应商拒绝缓存的 token（HTTP 401）时，都会自动重新进行身份验证。调用方只需提供长期有效的用户名/密码。

配置

环境变量说明
MSP360_USERNAMEMSP360 提供商门户用户名。
MSP360_PASSWORDMSP360 提供商门户密码。
MCP_TRANSPORTstdio（默认）或 http。
AUTH_MODEenv（默认，读取上述变量）或 gateway（通过 Conduit 网关注入的 X-MSP360-Username / X-MSP360-Password 标头按请求提供凭据）。
CONDUIT_S2S_SECRET设置后，HTTP 传输要求每个 /mcp 请求都携带有效的 X-Gateway-S2S 标头（Conduit sidecar 身份验证）。
LOG_LEVELdebug | info（默认）| warn | error。
请求限制
  • HTTP 请求正文上限为 256 KiB（262144 字节）。X-Gateway-S2S 检查通过后，若 Content-Length 超出上限，则返回带有 JSON-RPC 错误的 413；没有 Content-Length 的正文由 MCP SDK 传输设置上限。未经身份验证的请求仍会优先收到 401。
  • tools/call 参数上限为 10,000 个元素（包括任意深度的每个数组项和对象键）。超出上限的输入会返回 isError 工具结果，且不会被分发。

这些限制用于应对 CVE-2026-111768 / GHSA-46jr-4wx8-v453（验证期间内存耗尽）和 GHSA-f897-62hf-6gxq（请求正文 / 批次无上限）。

工具

公司
  • msp360_list_companies - 列出此提供商账户下的公司（客户组织）。
  • msp360_get_company - 按 ID 获取单个公司。
计算机
  • msp360_list_computers - 分页列出受管计算机（端点）。
  • msp360_get_computer - 按 HID 获取单台计算机。
备份计划
  • msp360_list_plans - 列出计算机上的备份/还原计划。
  • msp360_get_plan - 按 ID 获取单个计划。
  • msp360_get_plan_info - 获取计划的状态/信息。
  • msp360_get_plan_history - 获取计划的运行历史记录，可按日期筛选。
  • msp360_start_plan - 启动计划的备份运行。
  • msp360_stop_plan - 停止正在运行的计划备份。
监控
  • msp360_get_monitoring - 获取所有端点上最新计划运行的状态数据。
  • msp360_get_monitoring_for_user - 获取按用户筛选的最新计划运行状态数据。
许可证
  • msp360_list_licenses - 列出可用许可证，可选择仅显示未分配的许可证。
  • msp360_get_license - 按 ID 获取单个许可证。

范围

这是一个 v1 / MVP 功能集，涵盖 MSP 工作流的核心需求：“备份了什么，运行状态是否正常”。目前明确不在范围内的内容包括：管理员、账单、构建、软件包、目标位置/账户（存储配置）、用户/身份验证、许可证授予/释放/撤销（修改许可证分配），以及计算机授权/取消授权。这些属于提供商/经销商管理控制台级别的操作，会对实际账单和访问权限产生影响，与日常 MSP 监控不同；与其将它们纳入 v1，不如日后另行审慎决定。

开发

npm install
npm run build
npm test
npm run lint   # tsc --noEmit

Docker

docker build -t msp360-mcp .
docker run -p 8080:8080 -e MSP360_USERNAME=... -e MSP360_PASSWORD=... msp360-mcp

评论

支持 Markdown

第一次接触 MCP？

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

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