Crowdstrike Falcon

falcon-mcp

falcon-mcp 是一个模型上下文协议（MCP）服务，可将 AI Agent 与 CrowdStrike Falcon 平台连接起来，为 Agent 工作流中的智能安全分析提供支持。它以编程方式提供关键安全功能，包括检测、威胁情报和主机管理，为高级安全运营和自动化奠定基础。

重要

1.0 之前的版本：falcon-mcp 在 1.0 版本发布前仍在积极开发中。工具名称、参数和响应格式在次要版本之间仍可能发生变化，因此请固定版本，并在升级前查看更新日志。CrowdStrike 正在积极维护此项目，并通过 GitHub Issues 提供支持；CrowdStrike 客户也可以通过常用的技术支持渠道提出问题。详情请参阅 SUPPORT.md。

文档

完整文档请见 developer.crowdstrike.com/falcon-mcp。

模块

模块	描述
Core	基本连接和系统信息
AgentWorks	调用、列出并查看 Charlotte AI Agent 及其执行跟踪记录
Case Management	案例生命周期管理、证据附件、标签和模板
Cloud Security	Kubernetes 容器、映像漏洞、CSPM 资产清单、IOM 发现项、抑制规则、云风险、云洞察和云组
Correlation Rules	搜索、创建、更新和管理 NG-SIEM 关联规则
Custom IOA	创建和管理 Custom IOA 行为检测规则及规则组
Data Security	搜索、创建和更新 Data Security 分类、策略、内容模式、应用、Web 位置、敏感度标签和文件类型
Detections	查找、汇总和分析检测结果，以了解恶意活动
Discover	搜索应用清单和受管／非受管资产，包括驱动器加密和系统洞察状态
Exclusions	搜索、创建、更新和删除基于 IOA、机器学习、传感器可见性和证书的排除项
Firewall Management	搜索和管理防火墙规则及规则组
Fusion SOAR	搜索 Fusion SOAR 工作流定义和执行记录、读取执行结果，并按需运行工作流
Guardian	监控 AI Agent 活动、会话、工具使用情况和清单
Host Groups	搜索、创建、更新和删除主机组；管理组成员
Hosts	管理和查询主机／设备信息
Identity Protection	实体调查和身份保护分析
Intel	研究威胁行为者、IOC 和情报报告
IOC	搜索、创建和移除自定义入侵指标
NGSIEM	对 Next-Gen SIEM 执行 CQL 查询
Policies	搜索、创建、更新和删除预防、传感器更新、防火墙、设备控制、响应和内容更新策略；管理主机组分配、启用／禁用和优先级
Quarantine	搜索隔离记录、预览操作计数，以及释放、取消释放或删除隔离文件
Real Time Response	审计、汇总并运行只读 RTR 分类工作流
Recon	搜索和汇总 Falcon Intelligence Recon 通知（Recon 警报）、监控规则，以及暗网、凭据泄露和域名仿冒相关的暴露数据记录，并预览潜在规则产生的噪声
Scheduled Reports	管理计划报告并下载报告文件
Sensor Usage	访问和分析传感器使用情况数据
Serverless	搜索无服务器函数中的漏洞
Shield	SaaS 安全状态、检查项、警报和应用清单
Spotlight	管理和分析漏洞数据及安全评估
Zero Trust Assessment	获取主机的 Zero Trust Assessment 状态评分，以及传感器和 OS 加固信号
有关必需的 API 范围、可用工具和 FQL 资源，请参阅 模块概览。

说明

Guardian 模块读取 /aidr API，其路由和参数接口在不同的 Falcon 部署中尚未统一。在较旧的接口仍在使用的部署中，某些工具会返回 HTTP 400 或 404。详情请参阅 Guardian 模块文档。

快速开始

安装

使用 uv（推荐）

uv tool install falcon-mcp

使用 pip

pip install falcon-mcp

配置

设置必需的环境变量（或使用 .env 文件——请参阅配置指南）：

export FALCON_CLIENT_ID="your-client-id"
export FALCON_CLIENT_SECRET="your-client-secret"
export FALCON_BASE_URL="https://api.crowdstrike.com"

运行

falcon-mcp

完整的安装和配置信息，请参阅入门指南。

编辑器集成

使用 uvx（推荐）

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

选择模块

{
  "mcpServers": {
    "falcon-mcp": {
      "command": "uvx",
      "args": [
        "--env-file",
        "/path/to/.env",
        "falcon-mcp",
        "--modules",
        "detections,hosts,intel"
      ]
    }
  }
}

Docker

{
  "mcpServers": {
    "falcon-mcp-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file",
        "/full/path/to/.env",
        "quay.io/crowdstrike/falcon-mcp:latest"
      ]
    }
  }
}

有关所有命令行选项、模块配置和库用法，请参阅使用指南。

容器用法

# Pull the latest image
docker pull quay.io/crowdstrike/falcon-mcp:latest

# Run with .env file (stdio transport)
docker run -i --rm --env-file /path/to/.env quay.io/crowdstrike/falcon-mcp:latest

# Run with streamable-http transport (add --api-key when the port is reachable beyond localhost)
docker run --rm -p 8000:8000 --env-file /path/to/.env \
  quay.io/crowdstrike/falcon-mcp:latest \
  --transport streamable-http --host 0.0.0.0 --api-key your-secret-key

注意

HTTP 传输默认不进行身份验证。绑定到非环回地址（--host 0.0.0.0）会暴露一个未经身份验证的服务，任何能访问该端口的人都可以使用你的 CrowdStrike 凭据操作它。本地使用时请保留默认的环回绑定；绑定到更广泛的地址时，务必设置 --api-key。AWS Bedrock AgentCore 和 Google Cloud Run 等托管运行时位于其自身的网络安全层之后，因此不适用此情况。请参阅配置指南。

有关本地构建、自定义端口和高级配置，请参阅 Docker 部署指南。

动态模式

同时运行许多模块会增大每个 AI 客户端都必须容纳的上下文窗口。动态模式会用三个工具取代完整的工具接口：falcon_list_enabled_tools 用于查看服务可用的所有工具，falcon_search_tools 用于按关键词查找候选工具，然后获取所选工具的参数架构，falcon_execute_tool 用于运行工具。这样一来，Agent 只需加载实际需要的架构。

falcon-mcp --dynamic
# or: FALCON_MCP_DYNAMIC=true

有关完整的发现 → 执行工作流及其权衡，请参阅动态模式指南。

限制服务的操作范围

--modules 按模块启用，无法在模块内细分：启用模块以获取其搜索工具时，也会暴露该模块包含的所有变更类工具。以下三个工具级选项可以缩小操作范围。

# Investigation-only server: no tool that mutates tenant state is registered
falcon-mcp --read-only

# Expose exactly two tools, nothing else
falcon-mcp --tools falcon_search_detections,falcon_search_hosts

# Keep the module, drop one tool
falcon-mcp --modules hostgroups --exclude-tools falcon_delete_host_groups

# All of detections, plus one tool from a module you did not enable
falcon-mcp --modules detections --tools falcon_search_applications

标记	环境变量	作用
--read-only	FALCON_MCP_READ_ONLY	仅注册只读工具
--tools	FALCON_MCP_TOOLS	工具名称允许列表；在已启用的模块中添加指定工具
--exclude-tools	FALCON_MCP_EXCLUDE_TOOLS	工具名称拒绝列表

工具名称是客户端显示的、带有 falcon_ 前缀的名称。无法识别的名称会导致启动中止，而不是被忽略，因此拒绝列表中的拼写错误不会在不知情的情况下留下已暴露的工具。

组合选项

--tools 是叠加式的，而不是缩小范围的筛选器。它会在 --modules 已启用的内容之上，跨模块边界授予单个工具：

• 单独使用 --tools X 时，只会注册 X——默认不加载任何模块。
• 使用 --modules detections --tools X 时，会注册所有 detections 工具，以及 X，即使 X 属于未启用的模块。该模块只会提供 X，而非其全部工具；falcon_list_enabled_modules 也不会列出该模块。falcon_list_enabled_tools 会列出 X——它报告服务上可用的工具，因此是可靠的判断依据，可回答“此处是否提供此功能？”

若要排除工具，请使用 --exclude-tools 或 --read-only。这四个选项可以组合使用，并按固定顺序生效：

1. --exclude-tools 无条件移除指定工具，即使 --tools 列出了它也一样。
2. --read-only 无条件移除所有会修改数据的工具，即使 --tools 列出了它们也一样。
3. --tools 添加指定的工具，不受模块限制。
4. --modules 决定默认情况下哪些工具可供选择。

由于前两条规则始终优先，--read-only 和 --exclude-tools 可以安全地作为部署范围的底线：叠加式的 --tools 列表无法突破这些限制。组合使用它们，就能表达“搜索所有内容，不做任何更改，而且连那个工具也不提供”：

falcon-mcp --read-only --exclude-tools falcon_execute_rtr_read_only_command

筛选也适用于动态模式——被屏蔽的工具不会出现在 falcon_search_tools 结果中，调用 falcon_execute_tool 时也会被拒绝。由于动态模式按名称分发，而非逐个注册工具，拒绝信息会明确说明该工具确实存在，但服务配置将其屏蔽，并指出起作用的具体规则。这样一来，Agent 会将已禁用的工具报告为已禁用，而不是告诉用户该功能不存在。 在任一模式下，只要有规则生效，falcon_list_enabled_tools 就会包含 filters_active 字段。启动日志会报告哪些规则处于启用状态，以及 --read-only 和 --exclude-tools 屏蔽了多少工具，便于你确认部署配置。使用 --debug 运行，即可查看被屏蔽工具的名称。

这些选项筛选的是工具，而非资源。被屏蔽工具对应的 FQL 指南资源仍然可用——指南是静态字段文档，不包含租户数据。

部署选项

• Amazon Bedrock AgentCore
• Google Cloud（Agent Platform / Gemini Enterprise）

贡献

# Clone and install
git clone https://github.com/CrowdStrike/falcon-mcp.git
cd falcon-mcp
uv sync --all-extras

# Run tests
uv run pytest

重要

本项目使用 Conventional Commits 实现自动发布。请遵循 贡献指南中说明的提交消息格式。

开发者文档

• 文档指南：文档的架构和维护指南
• 模块开发指南：实现新模块的说明
• 资源开发指南：实现资源的说明
• 集成测试指南：使用真实 API 调用运行集成测试的指南

注册目录

falcon-mcp 已发布到公开 MCP 目录，便于在兼容客户端中发现并一键设置：

• MCP Registry
• GitHub MCP Registry
• Gemini CLI Extensions

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

支持

这是一个由社区驱动的开源项目。虽然它不是 CrowdStrike 的官方产品，但由 CrowdStrike 积极维护，并与开源开发者社区协作提供支持。

如需了解更多信息，请参阅我们的 SUPPORT 文件。