MCP Claude Plugins for MSP
使用说明(Markdown 格式)
-
项目简介
- 该仓库包含多套基于 MCP 的服务器实现,覆盖 PSA/RMM、文档、安保、财务等领域的厂商插件。服务器提供与厂商 API 的工具调用、资源访问和提示模板渲染能力,旨在为大语言模型客户端提供标准化的上下文服务与功能。
-
主要功能点
- MCP 服务器核心能力:处理 MCP 请求与响应,提供会话管理与能力声明。
- 工具管理:按厂商提供的工具集进行读取、调用,支持输入输出范式规范化。
- 资源与提示:通过技能、命令和提示模板实现对外部系统的接入与对话渲染。
- 多传输支持:使用标准的 MCP 服务器传输(如标准输入/输出),并在需要时可扩展为其它传输(SSE、WebSocket 等)。
- 安全与加密:包含 credential 存储、密钥派生与加密工具,确保凭证在服务器端的保护。
-
安装步骤(简化版)
- 通过 npm/Docker 等方式获取对应厂商的 MCP 服务器实现包(例如 autotask-mcp、datto-rmm-mcp、halopsa-mcp 等)。
- 在服务器环境中安装依赖,确保 Node.js 环境就绪。
- 启动 MCP 服务器实例,通常以 npx <包名> 启动,或按厂商指引构建成可执行服务。
- 使用 MCP Gateway/ Claude Desktop 等客户端连接该 MCP 服务器,进行身份认证和初始化。
- 客户端配置完成后,服务器即可响应资源、工具和提示相关的 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 等)进行安全与权限测试,确保凭证和访问权限符合业务要求。