MCP Claude Plugins for MSP

使用说明(Markdown 格式)

  • 项目简介

    • 该仓库包含多套基于 MCP 的服务器实现,覆盖 PSA/RMM、文档、安保、财务等领域的厂商插件。服务器提供与厂商 API 的工具调用、资源访问和提示模板渲染能力,旨在为大语言模型客户端提供标准化的上下文服务与功能。
  • 主要功能点

    • MCP 服务器核心能力:处理 MCP 请求与响应,提供会话管理与能力声明。
    • 工具管理:按厂商提供的工具集进行读取、调用,支持输入输出范式规范化。
    • 资源与提示:通过技能、命令和提示模板实现对外部系统的接入与对话渲染。
    • 多传输支持:使用标准的 MCP 服务器传输(如标准输入/输出),并在需要时可扩展为其它传输(SSE、WebSocket 等)。
    • 安全与加密:包含 credential 存储、密钥派生与加密工具,确保凭证在服务器端的保护。
  • 安装步骤(简化版)

    1. 通过 npm/Docker 等方式获取对应厂商的 MCP 服务器实现包(例如 autotask-mcp、datto-rmm-mcp、halopsa-mcp 等)。
    2. 在服务器环境中安装依赖,确保 Node.js 环境就绪。
    3. 启动 MCP 服务器实例,通常以 npx <包名> 启动,或按厂商指引构建成可执行服务。
    4. 使用 MCP Gateway/ Claude Desktop 等客户端连接该 MCP 服务器,进行身份认证和初始化。
    5. 客户端配置完成后,服务器即可响应资源、工具和提示相关的 JSON-RPC 请求。
  • 服务器配置(示例 JSON,供 MCP 客户端配制使用) 说明:MCP 客户端需要向 MCP 服务器提供一个配置,包含服务器名称、启动命令及参数。以下示例展示常见厂商 MCP 服务器的启动配置。请按实际部署的服务器选择对应配置。

    示例 1:Autotask MCP { "serverName": "autotask-mcp", "command": "npx", "args": ["@wyre-technology/autotask-mcp"], "notes": "启动 Autotask MCP 服务,用于 Claude 进行自动化工单、客户等操作的上下文与工具调用" }

    示例 2:Datto RMM MCP { "serverName": "datto-rmm-mcp", "command": "npx", "args": ["@wyre-technology/datto-rmm-mcp"], "notes": "Datto RMM 的 MCP 服务,提供设备、警报、站点等工具的访问能力" }

    示例 3:HaloPSA MCP { "serverName": "halopsa-mcp", "command": "npx", "args": ["@wyre-technology/halopsa-mcp"], "notes": "HaloPSA MCP 服务,提供工单、客户、资产等域的工具访问" }

    说明:以上配置中 serverName 对应 MCP 客户端在云端/本地网关的标识,command 与 args 与仓库中各厂商 MCP 的 installCommand 对应关系一致。实际环境中请采用对应厂商包的启动命令与参数,确保网关能够正确通过 JSON-RPC 调用 MCP 服务器。

  • 基本使用方法

    • 启动与连接:在 MCP 网关或 Claude Desktop 中使用上述配置启动 MCP 服务器实例,通过网关建立 JSON-RPC 通道。
    • 访问模式:客户端可对服务器发起 ListTools 请求以获取可用工具清单,随后对特定工具发起 CallTool 请求以执行操作。
    • 安全性:服务器端会通过环境变量提供的凭据进行鉴权,请确保凭据安全管理,必要时使用额外的密钥派生和加密措施。
    • 监控与调试:若出现鉴权失败、网络超时或工具未实现等情况,MCP 服务器应返回带有 clearly 标识的错误信息,开发者可据此排查。
  • 基本操作建议

    • 第一步:在 MCP 网关中添加一个或多个服务器条目,指定上述 serverName、command、args。
    • 第二步:在 Claude/LLM 对话中请求需要的工具,服务器将返回工具列表或执行结果。
    • 第三步:对重要厂商插件(如 Autotask、Datto、HaloPSA 等)进行安全与权限测试,确保凭证和访问权限符合业务要求。

服务器信息