mcp-server-action1

面向 Action1 端点管理（RMM/补丁管理）REST API 3.0 的 MCP 服务器。

免责声明： 这是一个由 Borgels 开发的独立非官方项目。Borgels 与 Action1 无关联，未经 Action1 认可，也未获得 Action1 支持。此处引用 "Action1" 和 Action1 API 仅用于描述此服务器所对接的对象。你需要自己的 Action1 凭据，并且使用 Action1 API 须遵守 Action1 自身的条款。

工具

读取（始终开启）： 组织、受管端点（清单、状态筛选、缺失更新）、端点组、更新/补丁（审批状态、严重性）、漏洞（CVE、受影响端点、修复措施）、已安装软件、软件仓库、脚本库、自动化（计划与包含每个端点结果的运行历史）、报告 + 报告数据、企业审计日志、能力发现。

写入（通过 ACTION1_ENABLE_WRITES=true 选择启用）： action1_set_update_approvals — 为单个组织批准/拒绝更新（补丁审批工作流）。拒绝 orgId="all"。

刻意不包含（RMM 安全）： 创建或运行自动化（run_script/deploy/reboot — 在端点上远程执行代码）、远程桌面会话、修改软件仓库（供应链风险）、删除/移动端点、用户/角色/组织管理、企业关闭。如果确实需要执行脚本，应将其放在单独的、具有职责门控的提交工具中。

Related MCP server: TuxCare ePortal MCP Server

认证与区域

OAuth2 客户端凭据模式对接 {base}/oauth2/token；令牌有效期恰为 3600 秒，并会自动缓存/续期。凭据在 Action1 控制台的 Configuration → Users & API Credentials 下创建。将 ACTION1_BASE_URL 设置为你的数据中心区域（欧盟：https://app.eu.action1.com/api/3.0）。

分页与速率限制

列表返回 {items, total_items, from, nextFrom} — 将 nextFrom 作为 from 传入以继续。Action1 建议每个企业保持在约 30 次请求/分钟以下；429 响应会显示 retry-after。

运行

npm install
npm run dev          # stdio
npm run dev:http     # streamable HTTP on :3000/mcp (stateless)
npm test

Docker 镜像：ghcr.io/borgels/mcp-server-action1（在推送到 main 时发布）。

部署

参见 deploy/ 下的 docker-compose 服务块、hosts.json 条目、反向代理站点块以及示例环境变量文件 — 针对你要暴露的每个 Action1 组织运行一个实例，前端由位于你的设备群之前的、支持 OAuth 的网关/反向代理负责。