Automox MCP Server

Automox MCP 服务

Automox 官方 MCP 服务。使用自然语言与 Automox 控制台交互——此 MCP 服务可将 Claude 等 AI 助手连接到你的 Automox 环境，让你只需提出请求，即可管理设备、检查合规情况、运行策略等。

You:   "Are we ready for Patch Tuesday?"
Claude: Here's your readiness summary — 3 devices need patches,
        2 approvals are pending, and your patch policies run tonight at 2 AM...

重要

如需报告 Bug 或提出功能请求，请使用 help.automox.com 或常用的升级渠道。

注意

AI 助手可能会出错。MCP 服务生成的回答可能不正确或不完整。如果这种情况持续发生，请告知我们。

目录

• 3.0 版新内容
• 自托管与托管服务
• 快速开始
• 我可以询问什么？
• 配置
• 安全性
• 隐私政策
• 其他安装方式
• 更新
• 迁移到托管服务
• 故障排除
• 常见问题
• 开发
• 版本管理
• 许可证
• 支持

3.0 版新内容

Automox MCP Server 3.0 新增了集中托管选项，可替代旧版自托管方案。托管服务支持你已经在使用的全部功能，并新增一项能力。

• **托管服务：**Automox 现在会为你运行并维护此服务的一个版本。无需安装，只需使用现有 API 密钥将 AI 客户端连接到 https://console.automox.com/api/mcp。请参阅下文的自托管与托管服务。
• **策略目录模板（仅限托管服务）：**托管服务可以搜索 Automox 的最佳实践策略模板库，并直接根据模板创建策略，让你无需从头构建策略即可开始使用。这与查询组织中已部署的策略不同；此功能使用的是 Automox 自己推荐的模板库。
• **功能不缩水：**托管服务提供的工具覆盖范围与你通过此代码库使用的相同。
• **不强制迁移：**此自托管服务和 Claude Desktop 扩展仍会照常运行。迁移到托管服务目前是可选的（但推荐迁移），请参阅迁移到托管服务。
• **身份验证目前保持不变：**两个版本都使用相同的 Automox API 密钥。未来版本计划支持 SSO。

自托管与托管

两者运行的是相同的开源服务代码。区别在于由谁安装和运行，以及目前仅托管版本具备的一项功能。

	自托管（本仓库）	托管（MCP Server 3.0）
安装	由你安装并保持更新（PyPI、uvx、Claude Desktop 扩展，或通过 Claude 的 Connectors Directory）	无需安装，由 Automox 运行
运行位置	你的设备	Automox 的多租户服务
身份验证	你的 Automox API 密钥	你的 Automox API 密钥（目前采用相同模式）
Claude Desktop	目前可通过一键扩展使用，可从 GitHub Releases 或 Claude 的 Connectors Directory 安装	暂不支持，Claude Desktop 内置的自定义连接器需要 OAuth，而托管服务目前尚不支持
其他客户端（Claude Code、Cursor、MCP Inspector 等）	通过本地配置使用	目前可通过带有 Bearer token 请求头的 HTTP 使用
适合以下情况	你想运行自己的基础设施，或目前使用 Claude Desktop	你想免于维护，并且使用支持自定义 HTTP 请求头的客户端

有关自托管设置，请参阅下文的快速开始。有关托管服务，请参阅迁移到托管服务，其中也介绍了如何在此前未安装过的情况下直接连接。

快速开始

1. 获取 Automox 凭据

你需要从 Automox 控制台获取以下三个值：

值	查找位置
API Key	使用组织级密钥 — 区域 Settings > Secrets & Keys > Add API Key（文档）；密钥类型见下文
Account UUID	Settings > Secrets & Keys（显示在页面上）
Org ID	查看组织时 URL 中的数字 ID

Automox 有两种 API 密钥类型，两者的区别在这里很重要：

	组织级密钥（推荐）	全局／账户密钥
范围	一个组织 — 创建该密钥的区域	账户中的所有组织；在每个组织中继承密钥所有者的角色
创建位置	区域 Settings > Secrets & Keys	账户 Global Access Management > Keys（Full Administrator）
工具覆盖范围	所有工具（已验证：搜索系列工具可立即使用）	高级设备搜索系列工具的使用不稳定 — advanced_device_search、device_search_typeahead、已保存搜索的创建／读取／更新／删除、list_searches_for_device、get_device_assignments — 在大多数组织中，即使是完全管理员也会遇到 403，但在其他组织中则可正常使用；上游授权行为不一致，具体机制尚未确认

症状： 搜索工具返回 403，而其他所有读取操作都正常，通常说明问题出在密钥，而不是你的权限 — 请为目标组织切换为组织级密钥。始终需要 API Key 和 Account UUID。建议提供 Org ID，但不是必需的 — 一些不需要组织上下文的工具无需 Org ID 也能使用。

2. 创建 .env 文件

AUTOMOX_API_KEY=your-api-key
AUTOMOX_ACCOUNT_UUID=your-account-uuid
AUTOMOX_ORG_ID=your-org-id

3. 连接到你的 AI 助手

Claude Desktop（推荐）——一键安装 MCPB：

**新增：**Automox MCP 现在也直接列在 Claude 的连接器目录中。打开 Claude Desktop，前往 设置 > 连接器，搜索“Automox”即可连接，无需离开应用。以下手动步骤仍然有效，内容没有任何变化。

1. 从 GitHub Releases 页面下载最新的 automox-mcp-<version>.mcpb。
2. 打开 Claude Desktop → 设置 → 扩展。
3. 将 .mcpb 文件拖入扩展窗口。
4. 根据提示粘贴你的 API 密钥、Account UUID，以及（可选）Org ID。

无需 .env 文件，也无需终端——凭据会存储在 Claude Desktop 的安全配置中。该软件包会在首次运行时从 PyPI 获取匹配的 automox-mcp 发行版。

Claude Code（命令行）：

claude mcp add automox-mcp uvx -- --env-file /path/to/.env automox-mcp

Cursor / 任何其他 MCP 客户端——添加到你的 MCP 配置中：

{
  "mcpServers": {
    "automox-mcp": {
      "command": "uvx",
      "args": ["--env-file", "/path/to/.env", "automox-mcp"]
    }
  }
}

就是这么简单。开始提问吧。

我可以询问什么？

该服务提供 130 多种工具，涵盖设备、策略、补丁、组、webhook、worklet、漏洞同步、维护时段等。你不必知道工具名称，只需描述你的需求：

这样询问	会发生什么
“我们准备好迎接 Patch Tuesday 了吗？”	检查待处理补丁、审批情况和策略计划
“我们的合规状况如何？”	返回合规率、不合规设备和运行状况细分
“提供 Caldera 服务器的完整配置文件”	汇总设备详情、库存、软件包和策略状态
“哪些设备需要关注？”	显示被标记为需要立即采取行动的设备
“重启设备 ‘Testing box’”	搜索该设备并发出重启命令
“为 Firefox 创建一个面向 ‘MCP testing’ 组的补丁策略”	使用合理的默认设置创建策略
“Mark Hansen 上周在 Automox 中做了什么？”	查询该日期范围内的审计记录
“查找所有 30 天内未出现的 Windows 设备”	使用结构化查询进行高级设备搜索
“显示漏洞修复状态”	列出包含问题、解决方案和进度的操作集
“在 worklet 目录中搜索 USB 安全”	浏览包含评估和修复代码的社区 worklet

如需查看完整的工具、参数和 MCP 资源列表，请参阅**工具参考**。

**提示：**你也可以直接询问服务本身——discover_capabilities 工具会按领域整理并返回所有可用工具。

配置

环境变量

仅适用于自托管的 2.x 服务。不适用于托管的 3.0+ 服务。

变量	必填	默认值	说明
AUTOMOX_API_KEY	是	—	Automox API 密钥（建议使用组织级密钥 — 请参阅密钥类型）
AUTOMOX_ACCOUNT_UUID	是	—	Secrets & Keys 中的账户 UUID
AUTOMOX_ORG_ID	建议填写	—	数字形式的组织 ID（大多数工具都需要）
AUTOMOX_MCP_READ_ONLY	否	false	禁用所有写入操作（保留 133 个工具中的 85 个）
AUTOMOX_MCP_ALLOW_APPLY_REMEDIATION_ACTIONS	否	false	启用 apply_remediation_actions 工具，该工具会立即在端点上修补／运行 worklet。默认关闭，即使处于写入模式也不例外。
AUTOMOX_MCP_ALLOW_SPLASHTOP_BULK_INSTALL_UNINSTALL	否	false	启用 splashtop_bulk_install_uninstall 工具，该工具可通过一次调用，在整个服务组中安装／卸载 Splashtop 客户端。默认关闭，即使处于写入模式也不例外。
AUTOMOX_MCP_ALLOW_DELETE_DEVICE	否	false	启用 delete_device 工具，该工具会永久删除设备记录及其历史记录（DELETE /servers/{id}）。此操作不可逆，且无法通过 MCP 重建。默认关闭，即使处于写入模式也不例外。
AUTOMOX_MCP_ALLOW_UPLOAD_POLICY_FILE	否	false	启用 upload_policy_file 工具，该工具会将本地安装程序文件上传到 Required Software 策略。该工具会读取本地文件系统，因此还需要设置 AUTOMOX_MCP_UPLOAD_ALLOWED_DIRS，且仅适用于 stdio（本地）传输。默认关闭，即使处于写入模式也不例外。
AUTOMOX_MCP_UPLOAD_ALLOWED_DIRS	否	—	以逗号分隔的绝对目录，upload_policy_file 可从中读取安装程序。该工具必须设置此项才能注册；路径会经过规范化处理，且必须解析到某个允许的目录内。
AUTOMOX_MCP_UPLOAD_MAX_BYTES	否	10737418240	upload_policy_file 的安装程序大小上限（默认 10 GB，即 Automox 的上限）。
AUTOMOX_MCP_UPLOAD_TIMEOUT_SECONDS	否	3600	upload_policy_file 的上传读／写超时（大型安装程序需要比默认请求超时更长的时间）。
AUTOMOX_MCP_MODULES	否	全部	以逗号分隔的待加载模块列表（见下文）
AUTOMOX_MCP_TOKEN_BUDGET	否	4000	截断前每条响应的估算令牌数上限
AUTOMOX_MCP_SANITIZE_RESPONSES	否	true	清理 API 数据以缓解提示词注入
AUTOMOX_MCP_TOOL_PREFIX	否	—	为所有工具名称添加前缀（例如 automox），以防止不同服务之间发生冲突
AUTOMOX_MCP_LOG_FORMAT	否	text	日志格式：text 或 json（用于 SIEM 集成的结构化 JSON）
AUTOMOX_MCP_TRANSPORT	否	stdio	传输方式：stdio、http、sse 或 streamable-http
AUTOMOX_MCP_HOST	否	127.0.0.1	HTTP/SSE 的绑定地址
AUTOMOX_MCP_PORT	否	8000	HTTP/SSE 的绑定端口
AUTOMOX_MCP_API_KEYS	否	—	以逗号分隔的 MCP 端点 API 密钥，用于 HTTP/SSE Bearer 令牌身份验证（例如 key1,label:key2）
AUTOMOX_MCP_API_KEY_FILE	否	—	包含 MCP 端点 API 密钥的文件路径（每行一个）
AUTOMOX_MCP_OAUTH_ISSUER	否	—	用于 JWT 身份验证的 OIDC 颁发者 URL（例如 https://auth.example.com/realms/main）
AUTOMOX_MCP_OAUTH_JWKS_URI	否	—	用于 JWT 密钥轮换的 JWKS 端点（若省略，则根据颁发者自动推导）
AUTOMOX_MCP_OAUTH_AUDIENCE	JWT 身份验证时必填	—	预期的 JWT audience 声明（防止令牌透传）；设置 AUTOMOX_MCP_OAUTH_ISSUER 时必填
AUTOMOX_MCP_OAUTH_SERVER_URL	否	—	规范服务器 URL；启用 RFC 9728 Protected Resource Metadata
AUTOMOX_MCP_OAUTH_SCOPES	否	—	以逗号分隔的必需 OAuth 作用域
AUTOMOX_MCP_ALLOWED_ORIGINS	否	—	DNS 重绑定防护的额外允许 Origin 标头（以逗号分隔）
AUTOMOX_MCP_ALLOWED_HOSTS	否	—	DNS 重绑定防护的额外允许 Host 标头（以逗号分隔）
AUTOMOX_MCP_DNS_REBINDING_PROTECTION	否	true	设为 false 可禁用 DNS 重绑定防护（不建议）
AUTOMOX_MCP_ALLOW_REMOTE_BIND	否	false	允许绑定到非环回地址（绑定到 0.0.0.0 或外部 IP 时必需）

只读模式

AUTOMOX_MCP_READ_ONLY=true

禁用所有写入操作。仅注册只读工具（133 个中有 85 个）。适用于审计和监控。

模块化加载

仅加载所需的工具模块：

AUTOMOX_MCP_MODULES=devices,policies

可用模块：audit、audit_v2、devices、device_search、policies、policy_history、users、groups、events、reports、packages、webhooks、worklets、data_extracts、vuln_sync、compound、policy_windows

两项设置可以组合使用：

AUTOMOX_MCP_READ_ONLY=true
AUTOMOX_MCP_MODULES=devices,policies

HTTP 传输

用于非 stdio 部署：

uvx --env-file .env automox-mcp --transport http --host 127.0.0.1 --port 8000

端点身份验证

通过 HTTP 或 SSE 部署时，可以要求对 MCP 端点进行身份验证（与 Automox API 密钥分开）。支持两种策略：

静态 API 密钥（简单）：

automox-mcp --generate-key                         # generate a key
export AUTOMOX_MCP_API_KEYS="amx_mcp_a1b2c3..."    # or use a key file

OAuth 2.1 / JWT（企业 IdP 集成）：

export AUTOMOX_MCP_OAUTH_ISSUER="https://auth.example.com/realms/main"
export AUTOMOX_MCP_OAUTH_AUDIENCE="https://mcp.example.com"
export AUTOMOX_MCP_OAUTH_SERVER_URL="https://mcp.example.com"  # enables RFC 9728 metadata

客户端必须在每个请求中包含 Authorization: Bearer <token>。未通过身份验证的请求会收到 401 Unauthorized 响应，并附带适当的 WWW-Authenticate 标头。对 stdio 传输无影响。

安全性

Automox MCP 服务专为企业部署而设计，采用纵深防御安全控制。

亮点：

• 只读模式（AUTOMOX_MCP_READ_ONLY）禁用全部 48 个写入工具

• 模块筛选（AUTOMOX_MCP_MODULES），以最低权限加载工具

• 每次工具调用都带有关联 ID，并作为 X-Correlation-ID 转发给 Automox API

• 速率限制（30 次调用/60 秒），支持令牌预算估算和自动截断

• API 密钥隔离——将密钥存储为私有属性，并在每次请求时注入身份验证信息（不存储标头）

• 通用错误响应——错误输出中不包含内部路径、连接字符串或 API 密钥

• 提示词注入缓解——对 API 响应进行清理，包括 Unicode 规范化、同形异义字符防护、HTML 标记/脚本剥离和引用式 Markdown 剥离

• Webhook 密钥处理——创建后从幂等缓存中剥离密钥

• 用于 SIEM 集成的结构化 JSON 日志（AUTOMOX_MCP_LOG_FORMAT=json）

• 工具名称前缀（AUTOMOX_MCP_TOOL_PREFIX），以防止不同服务之间发生冲突

• 使用 CycloneDX SBOM 的 Sigstore 签名版本

• SSRF 防护——根据私有/环回 IP 和云元数据端点验证 Webhook URL

• MCP 端点身份验证——静态 API 密钥或 OAuth 2.1/JWT，并支持受众绑定和 RFC 9728 受保护资源元数据

• DNS 重绑定防护——根据 MCP 传输规范，验证所有 HTTP/SSE 连接的 Origin 和 Host 标头

• 安全响应标头——所有 HTTP 响应均包含 X-Content-Type-Options、X-Frame-Options、CSP、Cache-Control: no-store、Strict-Transport-Security

• 身份验证速率限制——多次身份验证失败后封禁 IP，以缓解暴力破解攻击

• 远程绑定防护——非环回 HTTP/SSE 绑定需要显式启用 --allow-remote-bind

• 全部 130 多个工具均包含 MCP 工具注释——按照 MCP 协议规范提供 readOnlyHint、destructiveHint、idempotentHint 和 openWorldHint，以支持客户端确认对话框和安全防护

• 交互式 MCP Apps（io.modelcontextprotocol/ui）——为重要流程提供内嵌审核/审批界面：合规性分流、补丁审批、策略影响范围分析、修复应用和 RBAC 访问认证。支持 Apps 的宿主会内嵌渲染这些界面；其他宿主则会平稳降级为结构化工具输出。写入流程的 Apps 通过宿主的确认机制调用现有的受控工具——不新增工具，也不新增门控，并在宿主的默认拒绝 CSP 下运行（自包含，不加载外部资源/CDN）

• 61 项安全加固措施（V-001 至 V-182、S-001 至 S-006）记录在 CHANGELOG 和 SECURITY.md 中 能力模型。 此服务封装了 100% 已发布的 Automox Console API 和 Webhooks API，只有一个有意设定的例外——绝不封装会暴露机密的端点（API 密钥解密、设置密码）。所有破坏性操作要么需要先确认（由宿主确认），要么受默认关闭的环境变量标志控制。具体而言，有三条明确规则：

• 绝不处理机密——此服务绝不返回机密内容，也绝不允许模型设置机密。凭据仅通过环境变量／配置传入；解密端点不会封装，设置密码的操作会排除在外，并且所有投影中的机密字段都会被编辑。这是唯一有意的省略项。

• 破坏性操作分为两个级别。 针对单个目标、可恢复的操作需要先确认（destructiveHint: true，由宿主显示确认对话框，并且只读模式会完全禁用这些操作）。无法通过单次调用确认来保护你的操作——涉及整个设备群、自我锁定或由模型编写的任意代码执行——则受明确指定且默认关闭的环境变量标志控制（AUTOMOX_MCP_ALLOW_APPLY_REMEDIATION_ACTIONS、AUTOMOX_MCP_ALLOW_SPLASHTOP_BULK_INSTALL_UNINSTALL、AUTOMOX_MCP_ALLOW_DELETE_DEVICE）。删除设备的操作受控，而非省略。

完整的覆盖范围映射、控制原则和所有有意省略项，请参阅 API 覆盖范围与有意省略项。

有关漏洞报告和完整威胁模型，请参阅 SECURITY.md。 有关部署加固（容器、Kubernetes、MCP 网关、TLS、身份验证），请参阅部署安全指南。 安全状况依据 Wiz MCP 安全最佳实践速查表进行基准评估。

注意：对于可通过网络访问的部署，请启用端点身份验证（通过 AUTOMOX_MCP_API_KEYS 设置静态密钥，或通过 AUTOMOX_MCP_OAUTH_ISSUER 使用 JWT），并／或将此服务部署在 MCP 网关或带身份验证的反向代理之后。TLS 终止由部署者负责。

隐私政策

Automox MCP 服务充当你的 AI 助手与 Automox API 之间的无状态代理。

数据收集： 除了满足 Automox 平台 API 请求所需的数据外，此服务不会收集、存储或传输任何用户数据。API 凭据会在启动时从环境变量中读取，仅用于验证 Automox API 请求。

数据使用： 从 Automox API 检索的所有数据都会直接返回给发起请求的 AI 助手。此服务会对响应进行清理（Unicode 规范化、剥离 HTML），以防御提示词注入，但不会分析、汇总或将 API 数据用于任何其他目的。

第三方共享： 此服务不会与任何第三方共享数据。它仅使用你提供的凭据与 Automox API（console.automox.com）通信。不会向服务作者或任何其他服务发送遥测、分析或使用数据。

数据保留： 此服务不会在会话之间保留任何持久数据。进程退出时，内存缓存（幂等键、速率限制计数器）会被清除。启用结构化日志时，日志会写入 stderr，其管理和保留由部署者负责。

完整隐私政策请参阅 Automox MCP 服务隐私政策（内容镜像于 PRIVACY.md）。

其他安装方式

上文的快速入门使用 uvx，无需安装。如果你希望进行持久安装：

# Using uv
uv tool install automox-mcp

# Using pip
pip install automox-mcp

然后在 shell 中设置环境变量并运行 automox-mcp。

更新

如果你已经安装了服务，请更新到最新版本：

# uvx (Quick Start method) — force a cache refresh
uvx --refresh automox-mcp

# uv tool install
uv tool upgrade automox-mcp

# pip
pip install --upgrade automox-mcp

注意：uvx 大约每 7 天会自动刷新一次缓存，因此大多数用户无需操作即可使用新版本。运行 uvx --refresh 可立即获取最新版本。

迁移到托管服务

Automox MCP Server 3.0（托管版）运行的工具与本仓库相同，只是不需要维护本地安装。迁移分两步：移除本地服务，然后连接到托管服务。无需原地升级，也无需转换任何内容；无需迁移配置文件，也无需移植数据。如果你以前从未运行过 Automox MCP 服务，请直接跳到第 2 步，无需安装软件包。

第 1 步：移除本地服务

Claude Code：

claude mcp remove automox

Cursor 或其他基于配置的客户端：从 MCP 配置文件中移除 automox-mcp 条目。

Claude Desktop / MCPB 扩展：打开 Claude Desktop，然后前往 设置 → 扩展。找到 Automox，然后将其关闭（之后可以重新开启），或选择 卸载以将其彻底移除。之后重启 Claude Desktop，这样旧工具就不会再显示。移除之前请注意，目前还无法通过 Claude Desktop 使用托管服务。Claude Desktop 的自定义连接器要求使用 OAuth，而托管服务目前不支持 OAuth。如果你在 Claude Desktop 中使用 Automox，请保留已安装的扩展；只有在切换到能够连接托管服务的客户端（例如 Claude Code 或 Cursor）时，再移除该扩展。

第 2 步：连接到托管服务

Claude Code：

claude mcp add --transport http automox \
  https://console.automox.com/api/mcp \
  --header "Authorization: Bearer YOUR_AUTOMOX_API_KEY"

打开一个新会话，并询问类似“我们的合规状况如何？”这样的问题。

MCP Inspector（用于评估或调试）：

npx @modelcontextprotocol/inspector

在界面中设置：传输类型 = Streamable HTTP，URL = https://console.automox.com/api/mcp，身份验证 → Bearer Token = 你的 API 密钥（粘贴原始密钥）。点击 Connect，然后选择 Tools → List Tools。

其他 MCP 客户端（Cursor 等）：任何支持使用自定义标头的 Streamable HTTP 客户端：

URL:      https://console.automox.com/api/mcp
Header:   Authorization: Bearer YOUR_AUTOMOX_API_KEY

你在 Automox 中的权限与在控制台和 API 中的权限完全相同。MCP 会以你的身份操作。在过渡期间，你的自托管安装会继续运行，无需急着切换。

故障排除

症状	原因 / 解决方法
在 Claude Desktop 的“自定义连接器”界面中添加托管服务失败	Claude Desktop 内置的自定义连接器只支持通过 OAuth 登录。托管服务目前还不支持 OAuth，只接受 API 密钥，因此在此处粘贴托管服务 URL 会失败。这与 Automox MCP 桌面扩展不是一回事：请改为安装该扩展（可一键安装 .mcpb，也可在 Claude 的连接器目录中找到）。该扩展会在本地计算机上运行服务，并使用你已有的同一 API 密钥进行连接，因此仍可在 Claude Desktop 中使用全部功能，只是通过扩展而非自定义连接器界面来使用。
401 Unauthorized	缺少 Authorization: Bearer 标头，或密钥错误。请按 Bearer <key> 的格式原样发送密钥。
出现“OAuth Authentication Failed”或 JSON 无效相关错误	客户端在收到 401 后回退到了 OAuth 发现流程。请修正 Bearer 标头，而不是尝试使用自定义标头名称。
部分工具返回 403 Forbidden	检查密钥的作用范围。请使用组织范围的密钥。某些用户管理功能需要管理员作用范围。
答案看起来不准确	AI 助手可能会出错。采取行动前，请在 Automox Console 中核实重要结果。

常见问题

我的自托管 2.x 服务会停止工作吗？ 不会。你现有的自托管安装会继续运行，不会有任何变更，也不会影响你获取它的方式。如果你想使用托管服务，可以按自己的计划选择使用，无需切换。

迁移到托管服务后，我会失去任何功能吗？ 不会。托管服务运行的工具与你目前可使用的相同。

我需要切换到 SSO 吗？ 目前不需要。托管服务使用的 API 密钥模式与你目前使用的相同。未来版本计划支持 SSO 和按用户身份验证，届时我们会提供清晰的迁移指南。

我使用 Claude Desktop。应该怎么做？ 目前请继续使用 Automox MCP 桌面扩展。Claude Desktop 的原生连接器选项需要 OAuth，而托管服务目前尚不支持。

需要帮助？请通过 help.automox.com 联系我们。

开发

git clone https://github.com/AutomoxCommunity/automox-mcp.git
cd automox-mcp
uv python install
uv sync --python 3.13 --dev

测试

使用 MCP Inspector 进行交互式调试：

fastmcp dev

运行单元测试：

uv run --python 3.13 --dev pytest

运行生产环境冒烟测试（需要 Automox 凭据）：

uv run python tests/smoke_production.py

MCP Scanner

使用 Cisco 的 MCP Scanner 进行静态分析：

mcp-scanner \
  --analyzers yara \
  --format summary \
  stdio \
  --stdio-command uv \
  --stdio-arg run \
  --stdio-arg automox-mcp \
  --stdio-env AUTOMOX_API_KEY=test-api-key \
  --stdio-env AUTOMOX_ACCOUNT_UUID=test-account \
  --stdio-env AUTOMOX_ORG_ID=1 \
  --stdio-env AUTOMOX_MCP_SKIP_DOTENV=1

版本控制

遵循语义化版本。更新 pyproject.toml，提交、更改标签（例如 v0.1.0）并推送——发布工作流会自动发布到 PyPI。

许可证

MIT 许可证。请参阅 LICENSE。

支持

Automox 官方 MCP 服务。如有疑问、错误报告或功能请求，请使用 help.automox.com。

如需报告安全漏洞，请参阅 SECURITY.md——请勿公开创建 issue。