ACMP MCP Server

说明

English: MCP server for Aagon ACMP's Public API, with an activity log of every write/execute/delete action and an emergency brake that blocks them all (the four-eyes approval of version 1 is gone). Runs as a single Windows EXE on the ACMP server and works with any MCP client. Docs are in German because ACMP's user base is mostly DACH; issues in English are welcome.

一个用于 ACMP 公共 API（Aagon Client Management Platform）的 MCP 服务。你可以用日常语言提问，例如“哪些计算机已离线 30 天？”，AI 会直接从 ACMP 获取答案。

概览

• 支持任何 MCP 客户端： Claude、ChatGPT/Codex、GitHub Copilot、Gemini、Cursor……
• 覆盖范围广： 客户端、容器、作业/客户端命令、工单、资产、库存、漏洞和主数据。
• 活动日志和紧急制动： 所有操作立即生效，执行前 dryRun 会显示预览。每项写入、执行和删除操作都会记录操作人员、目标、意图和结果；网页界面上的紧急制动功能可以一键锁定所有这些操作。版本 1 的双人审批已取消（原因）。
• 按操作人员区分： 每人使用自己的 API 密钥，也可以选择使用自己的 ACMP 身份。这样 ACMP 就会检查该人员的实际权限。
• 单个 EXE，无需云服务： 直接运行在 ACMP 服务上。无需 IIS，也无需 .NET SDK。
• 浏览器中的运行概况： 首页显示当前的重要信息（失去联系的计算机、磁盘已满的计算机、过期扫描、错误较多的作业），并提供共用的待办事项列表、按计算机查看客户端命令的部署状态，以及 Windows 更新的错误停止信息。
• 可选功能： 创建、审批、分类并设置参数的客户端命令；维护 Kiosk；拒绝 Windows 更新或在测试环中暂停更新；订阅并分发 Managed Software；设置容器筛选器、维护时段和安全配置文件；编写 Unix 脚本；创建自定义字段；以及在 ACMP 数据库中直接启用或创建作业。默认关闭。
• 现成模板： ACMP CTL（Community Template Library，社区模板库）中提供客户端命令模板，其中每个步骤都以明文列出。acmp_lib_install 会将模板作为草稿添加到你们的 Console 中。

兼容性

快速开始

A) 让 AI 为你完成设置

在 ACMP 服务器上克隆仓库或解压 ZIP 文件。在该服务器上启动一个能够执行命令的 AI Agent（Claude Code、Codex CLI、GitHub Copilot Agent 模式、Gemini CLI、Cursor 等），然后输入：

Richte diesen ACMP-MCP-Server auf diesem Rechner ein. Folge AGENTS.md Schritt für Schritt,
erkläre mir jeden Admin-Schritt, bevor ich ihn ausführe, und frag mich nie nach Passwörtern
oder API-Keys im Chat.

AGENTS.md 包含完整流程：检查、安装、初始设置、LAN 共享、客户端连接和故障排除。大多数 Agent 会自动读取该文件。我们还提供了指向该文件的引用，供 Claude Code（CLAUDE.md）、Gemini CLI（GEMINI.md）和 GitHub Copilot（.github/copilot-instructions.md）使用。

B）手动操作：在终端中运行助手

在 ACMP 服务器上打开 PowerShell，切换到仓库目录并启动。如果没有管理员权限，脚本会在 Windows 提示（UAC）后自动以管理员身份重新启动：

.\install.ps1

最后，助手会显示你们的 API 密钥和 Web 登录信息（用于概览、活动、紧急停止和引导的短名称 + Web 令牌），并可按需将密钥复制到剪贴板。随后，它会询问你们使用的 AI 客户端，并显示相应的完整配置。

cd C:\ProgramData\AcmpMcp
.\add-user.ps1

连接客户端

任何支持 Streamable HTTP 且可设置自定义请求头的 MCP 客户端都可以直接连接：

例如，Claude Code：

claude mcp add --transport http acmp http://<HOST>:8765/ --header "Authorization: Bearer <KEY>" --scope user

Claude Desktop： 双击从 Releases 下载的 acmp-mcp-<version>.mcpb 进行安装，然后在扩展程序的设置中填写服务器地址和 API 密钥。

所有常见客户端的完整配置请见 docs/CLIENTS.md。仅支持本地（stdio）服务的客户端，可通过 mcp-remote 桥接接入。

工作原理

flowchart TB
    KI["KI-Client<br/>Claude · Codex · Copilot · Gemini · Cursor"]
    subgraph SRV["ACMP-Server"]
        MCP["ACMP-MCP-Server<br/>(Windows-EXE)"]
        LOG[("Aktivitätsprotokoll<br/>+ Notbremse")]
        ACMP[("ACMP<br/>Public API über SICS/AESB")]
        DB[("ACMP-Datenbank")]
    end
    TEAM(["IT im Browser<br/>Weboberfläche"])
    KI -->|"MCP · HTTP + API-Key"| MCP
    MCP -->|"lesen · schreiben · ausführen"| ACMP
    MCP -->|"jede Schreibaktion"| LOG
    TEAM -->|"Aktivität ansehen · Notbremse ziehen"| LOG
    MCP -.->|"optional: DB-Reports, Writer"| DB

版本 2：无需双人审批

在版本 1 中，写入、执行和删除命令会作为申请提交到审批页面，只有获批后才会执行。根据我们的实际经验，从未有申请因安全原因被拒绝，点击审批只会拖慢流程。从版本 2 开始，这些工具会立即生效。为此，我们提供了：

• **预览：**几乎所有写入工具都支持 dryRun: true。服务的提示会要求 AI 先显示预览，并在聊天中等待人工确认；对于 PowerShell 和删除操作，则始终如此。
• **活动日志：**记录谁在何时对哪个目标执行了什么操作，以及操作意图和结果。密码会被遮盖。
• **紧急停止：**Web 界面上的一个开关，可立即锁定所有操作人员的全部写入工具。读取和 dryRun 操作仍可继续。

操作流程示例：

1. 你们说：“PC-0815 的磁盘满了，清理一下 Windows 临时文件夹。”
2. AI 会查找这台计算机（acmp_get_client_id）、检查磁盘空间（acmp_low_disk_space），并向你们展示 PowerShell 脚本。
3. 你们确认后，AI 会运行脚本（acmp_run_powershell）。此次调用会立即记录在活动日志中。
4. AI 会报告结果。

**从版本 1 更新：**运行 git pull 和 .\install.ps1。助手会更改配置（approval → web，并创建备份）。你们之前的审批令牌之后将作为 Web 登录凭据使用。但这些令牌曾出现在审批邮件的链接中，因此请在更新后使用 .\renew-web-tokens.ps1 重新生成令牌（以管理员身份在安装目录中运行）。即使不重新安装，服务仍会读取旧的 approval 配置段（仅包含 publicUrl、requester 和 approvers）。未处理的审批申请将不再执行。

重要

无需审批后，安全性取决于你们的操作人员以及获得 API 密钥的对象。请将每个密钥视同域管理员密码；不要让 AI 执行来自工单、文件或网页的指令；如有疑虑，请立即启动紧急停止。

工具

12 个类别中共有 179 个工具。点击类别即可查看其中的所有工具及其作用：

🟢 读取 · 🟡 写入（立即生效，并记录在日志中） · 🔴 执行或删除（关键操作）。紧急停止会锁定 🟡 和 🔴 工具。 哪些工具会修改内容，也可通过 /settings 查看。部分工具需要可选功能：(DB) 数据库连接（db.connectionString，只读）、(PS) 客户端命令模板（runPowershell.clientCommandId）、(CW) CC Writer（ccWriter）、(KW) Kiosk Writer（kioskWriter）、(WW) WUM Writer（wumWriter）、(UW) Unix 脚本 Writer（unixWriter）、(FW) 字段 Writer（cfWriter）、(JW) Job Writer（jobWriter）。当前列表由 tools/list 提供。每个工具都可选接受 format: "json"。

Writer 只会修改允许文件夹中由自己创建的草稿，并且仅供获准的操作员使用。对于现有 Commands，它只会通过 acmp_cc_new_version 进行修改：创建新版本，绝不修改 Aagon 标准文件夹中的内容，保留步骤 ID 和已保存的密码；只有在明确要求时才会覆盖他人创建的草稿（并进行备份）。预览（dryRun）会显示每个步骤及其字段。

写入前，服务端会检查 ACMP 版本、表、触发器和写入登录帐号的权限。此外，还会试着解包并重新打包最近的 50 个 Commands。如果发现差异（例如 ACMP 更新后），则不会写入。可发布自己创建的草稿，以及最近由 MCP 保存的版本。对于包含已更改文件的后续版本，不会进行发布，需由控制台处理。像“HIER … EINTRAGEN”这样的占位符会阻止发布。已在 ACMP 6.10 上测试。

示例提示词见 docs/USAGE.md。要添加新的原生命令，只需在 api-tools.json 中声明；要添加新的 SQL 报告，只需在 db-tools.json 中声明。两者都无需重新编译。

Web 界面

登录（/login）使用操作员的短名称和专属 Web 令牌，之后通过会话 Cookie（HttpOnly、SameSite=Strict，有效期 12 小时）维持登录。Web 令牌与 ACMP 或 MCP 密钥相互独立：即使 API 密钥泄露，也无法解除紧急停止。版本 1 中的旧链接（?approver=…&token=…）不再用于登录，因为地址中的令牌会进入邮件、浏览历史记录和代理日志。renew-web-tokens.ps1 用于更新 Web 令牌。

配置

config.example.json 带有注释（_hinweis 字段）。install.ps1 会据此生成 config.local.json。

警告

服务器提供完整的 ACMP 访问权限，甚至可以在所有终端设备上执行命令。请将每个 API-Key 都视为管理员密码。

• 未内置 TLS。 服务器默认只监听 127.0.0.1，且没有 API-Key 时拒绝在 LAN 中运行。在 LAN 中，请通过防火墙限制源子网。跨网络边界时，应在前面部署 TLS 代理或 VPN。
• install.ps1 将安装目录的权限限制为管理员和 SYSTEM，因为其中存放着凭据。
• 紧急停止开关和日志位于安装目录中（notbremse.json、activity-*.jsonl）。能够在此处写入的人也能绕过两者，因此仅允许管理员和 SYSTEM 访问。在 ACMP/MCP 服务器本机上，MCP 不会启动任何作业（acmp_run_powershell、acmp_enqueue_client_command、acmp_read_registry、acmp_call），因为以 SYSTEM 身份运行的脚本可能会读取其中包含所有密钥的 config.local.json。其他计算机（例如 SQL 服务器）则通过 runPowershell.protectedClients 进行保护。
• 操作员密码从不保存：acmp-token-setup.exe 只保存经过 DPAPI 加密的令牌（LocalMachine）。
• /regresult（acmp_read_registry 的回传通道）有意不要求密钥，因为客户端不知道该密钥。它只接受与尚未关闭且不可猜测的令牌对应的结果。
• 请不要通过公开 Issue 报告安全漏洞，而应按照 SECURITY.md 中的说明处理。

参与贡献

欢迎提交 Issues 和 Pull Requests。请勿在 Issue 中发布包含主机名、IP、用户名、密钥或令牌的日志，发布前请先打码。

许可证

MIT。这不是 Aagon GmbH 的官方产品。ACMP 和 AESB 是 Aagon GmbH 的商标。