falcon-mcp

falcon-mcp es un servidor de Model Context Protocol (MCP) que conecta agentes de IA con la plataforma CrowdStrike Falcon, impulsando el análisis de seguridad inteligente en tus flujos de trabajo agénticos. Proporciona acceso programático a capacidades de seguridad esenciales, incluyendo detecciones, inteligencia de amenazas y gestión de hosts, estableciendo la base para operaciones de seguridad avanzadas y automatización.

[!IMPORTANT] 🚧 Vista previa pública: Este proyecto se encuentra actualmente en vista previa pública y en desarrollo activo. Las características y funcionalidades pueden cambiar antes del lanzamiento estable 1.0. Si bien fomentamos la exploración y las pruebas, evita implementaciones en producción. Agradecemos tus comentarios a través de GitHub Issues para ayudar a dar forma a la versión final.

Documentación

La documentación completa está disponible en developer.crowdstrike.com/falcon-mcp.

Related MCP server: falcon-mcp

Módulos

Consulta la Descripción general de módulos para conocer los alcances de API requeridos, las herramientas disponibles y los recursos FQL.

Inicio rápido

Instalación

Usando uv (recomendado)

uv tool install falcon-mcp

Usando pip

pip install falcon-mcp

Configuración

Establece las variables de entorno requeridas (o usa un archivo .env — consulta la Guía de configuración):

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

Ejecución

falcon-mcp

Consulte la guía de inicio para obtener detalles completos de instalación y configuración.

Integración con el editor

Uso de uvx (recomendado)

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

Con selección de módulos

{
  "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"
      ]
    }
  }
}

Consulte la guía de uso para todas las opciones de línea de comandos, configuración de módulos y uso de la biblioteca.

Uso en contenedor

# 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] Los transportes HTTP no tienen autenticación por defecto. Vincular a una dirección que no sea de bucle local (--host 0.0.0.0) expone un servidor sin autenticación que cualquiera que pueda alcanzar el puerto puede manejar con sus credenciales de CrowdStrike. Mantenga el enlace de bucle local por defecto para uso local y establezca --api-key siempre que se vincule a un rango más amplio. Los entornos administrados como AWS Bedrock AgentCore y Google Cloud Run están detrás de su propia capa de seguridad de red, por lo que esto no se aplica a ellos. Consulte la guía de configuración.

Consulte la guía de implementación de Docker para compilar localmente, puertos personalizados y configuraciones avanzadas.

Modo dinámico

Ejecutar muchos módulos a la vez infla la ventana de contexto que cada cliente de IA debe mantener. El modo dinámico reemplaza la superficie completa de herramientas con tres herramientas: falcon_list_enabled_tools para ver cada herramienta que el servidor tiene disponible, falcon_search_tools para encontrar herramientas candidatas por palabra clave y luego obtener el esquema de parámetros de la que elija, y falcon_execute_tool para ejecutarla, de modo que los agentes solo carguen los esquemas que realmente necesitan.

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

Consulte la guía de modo dinámico para conocer el flujo completo de descubrir → ejecutar y las ventajas y desventajas.

Restricción de lo que un servidor puede hacer

--modules es todo o nada por módulo: habilitar uno para obtener sus herramientas de búsqueda también expone todas las herramientas de mutación que conlleva. Tres opciones a nivel de herramienta reducen esa superficie.

# 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

Los nombres de herramientas son los nombres con prefijo falcon_ que muestra su cliente. Un nombre no reconocido aborta el inicio en lugar de ignorarse, por lo que un error tipográfico en una lista de denegados no puede dejar una herramienta expuesta silenciosamente.

Composición de las opciones

--tools es aditivo, no un filtro de reducción. Otorga herramientas individuales además de lo que --modules ya habilitó, cruzando el límite del módulo:

• --tools X por sí solo registra solo X: no se cargan módulos por defecto.

• --modules detections --tools X registra todas las herramientas de detections más X, incluso cuando X pertenece a un módulo que no está habilitado. Ese módulo contribuye solo X, no toda su superficie, y falcon_list_enabled_modules no lo lista. falcon_list_enabled_tools sí lista X: informa las herramientas disponibles en el servidor, por lo que es la respuesta confiable a "¿está disponible esta capacidad aquí?"

Para restar, use --exclude-tools o --read-only. Las cuatro opciones se combinan y se resuelven en un orden fijo:

1. --exclude-tools elimina una herramienta incondicionalmente, incluso si --tools la nombra.

2. --read-only elimina todas las herramientas de mutación incondicionalmente, incluso si --tools las nombra.

3. --tools agrega las herramientas que nombra, omitiendo la puerta del módulo.

4. --modules decide qué herramientas son candidatas por defecto.

Debido a que las dos primeras reglas siempre ganan, --read-only y --exclude-tools son seguros de establecer como un piso a nivel de implementación: una lista aditiva de --tools no puede ampliarse más allá de ellos. Combinarlos es cómo se expresa "buscar todo, no cambiar nada, y ni siquiera ofrecer esa herramienta":

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

El filtrado también se aplica al modo dinámico: una herramienta retenida está ausente de los resultados de falcon_search_tools y es rechazada por falcon_execute_tool. Debido a que el modo dinámico despacha por nombre en lugar de registrar herramientas individualmente, ese rechazo indica que la herramienta existe pero la configuración del servidor la retiene, y nombra la regla responsable, por lo que un agente informa una herramienta deshabilitada como deshabilitada en lugar de decirle al usuario que la capacidad no existe. falcon_list_enabled_tools lleva un campo filters_active en cualquier modo siempre que una regla esté en efecto. El registro de inicio informa qué reglas están activas y cuántas herramientas --read-only y --exclude-tools retuvieron, para que pueda confirmar lo que implementó. Ejecute con --debug para ver las herramientas retenidas por nombre.

Estas opciones filtran herramientas, no recursos. El recurso de guía FQL de una herramienta retenida permanece disponible: las guías son documentación estática de campos que no contienen datos de inquilino.

Opciones de implementación

• Amazon Bedrock AgentCore

• Google Cloud (Agent Platform / Gemini Enterprise)

Contribuciones

# 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] Este proyecto utiliza Conventional Commits para lanzamientos automatizados. Siga el formato de mensaje de confirmación descrito en nuestra Guía de contribución.

Documentación para desarrolladores

• Guía de documentación: Guía de arquitectura y mantenimiento para la documentación

• Guía de desarrollo de módulos: Instrucciones para implementar nuevos módulos

• Guía de desarrollo de recursos: Instrucciones para implementar recursos

• Guía de pruebas de integración: Guía para ejecutar pruebas de integración con llamadas reales a la API

Registros

falcon-mcp se publica en catálogos MCP públicos para su descubrimiento y configuración con un clic en clientes compatibles:

• MCP Registry

• GitHub MCP Registry

• Gemini CLI Extensions

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulte el archivo LICENSE para obtener más detalles.

Soporte

Este es un proyecto de código abierto impulsado por la comunidad. Si bien no es un producto oficial de CrowdStrike, es mantenido activamente por CrowdStrike y cuenta con el apoyo de la comunidad de desarrolladores de código abierto.

Para obtener más información, consulte nuestro archivo SUPPORT.