falcon-mcp

falcon-mcp — это сервер Model Context Protocol (MCP), который подключает AI-агентов к платформе CrowdStrike Falcon, обеспечивая интеллектуальный анализ безопасности в ваших агентных рабочих процессах. Он предоставляет программный доступ к ключевым возможностям безопасности — включая обнаружения, разведку угроз и управление хостами — создавая основу для продвинутых операций безопасности и автоматизации.

[!IMPORTANT] 🚧 Публичная предварительная версия: Этот проект находится в стадии публичной предварительной версии и активно разрабатывается. Функции и возможности могут измениться до стабильного релиза 1.0. Мы приветствуем изучение и тестирование, но просим избегать производственных развертываний. Мы будем рады вашим отзывам через GitHub Issues, чтобы помочь сформировать финальный релиз.

Документация

Полная документация доступна на developer.crowdstrike.com/falcon-mcp.

Related MCP server: falcon-mcp

Модули

См. Обзор модулей для получения информации о требуемых областях API, доступных инструментах и ресурсах FQL.

Быстрый старт

Установка

Использование 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

[!CAUTION] HTTP-транспорты по умолчанию не имеют аутентификации. Привязка к адресу, отличному от loopback (--host 0.0.0.0), открывает неаутентифицированный сервер, которым может управлять любой, кто может дотянуться до порта, используя ваши учетные данные CrowdStrike. Для локального использования оставляйте привязку к loopback по умолчанию и задавайте --api-key всякий раз, когда расширяете область привязки. Управляемые среды выполнения, такие как AWS Bedrock AgentCore и Google Cloud Run, находятся за собственным сетевым уровнем безопасности, поэтому это к ним не относится. См. руководство по конфигурации.

См. руководство по развертыванию Docker для локальной сборки, настройки пользовательских портов и расширенных конфигураций.

Динамический режим

Одновременный запуск множества модулей раздувает контекстное окно, которое должен удерживать каждый ИИ-клиент. Динамический режим заменяет полную поверхность инструментов тремя инструментами — falcon_list_enabled_tools для просмотра всех инструментов, доступных на сервере, falcon_search_tools для поиска подходящих инструментов по ключевым словам и получения схемы параметров для выбранного, и falcon_execute_tool для его запуска, — поэтому агенты загружают только те схемы, которые им действительно нужны.

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

Имена инструментов — это имена с префиксом 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. Поскольку динамический режим отправляет по имени, а не регистрирует инструменты по отдельности, это отклонение поясняет, что инструмент существует, но конфигурация сервера скрывает его, и называет единственное ответственное правило, поэтому агент сообщает об отключенном инструменте как об отключенном, а не говорит пользователю, что возможность не существует. 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

[!IMPORTANT] Этот проект использует Conventional Commits для автоматических релизов. Пожалуйста, следуйте формату сообщений коммитов, описанному в нашем руководстве по участию.

Документация для разработчиков

• Руководство по документации: Архитектура и руководство по сопровождению документации

• Руководство по разработке модулей: Инструкции по реализации новых модулей

• Руководство по разработке ресурсов: Инструкции по реализации ресурсов

• Руководство по интеграционному тестированию: Руководство по запуску интеграционных тестов с реальными вызовами API

Реестры

falcon-mcp публикуется в публичных каталогах MCP для обнаружения и настройки в один клик в совместимых клиентах:

• MCP Registry

• GitHub MCP Registry

• Gemini CLI Extensions

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Поддержка

Это управляемый сообществом проект с открытым исходным кодом. Хотя это не официальный продукт CrowdStrike, он активно поддерживается CrowdStrike и развивается в сотрудничестве с сообществом разработчиков открытого исходного кода.

Дополнительную информацию см. в нашем файле SUPPORT.