falcon-mcp

falcon-mcp は、AIエージェントとCrowdStrike Falconプラットフォームを接続するModel Context Protocol (MCP)サーバーであり、エージェンティックワークフローにおけるインテリジェントなセキュリティ分析を実現します。検出、脅威インテリジェンス、ホスト管理などの主要なセキュリティ機能へのプログラムによるアクセスを提供し、高度なセキュリティ運用と自動化の基盤を確立します。

[!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

インストールと設定の詳細については、Getting Startedガイドを参照してください。

エディタ統合

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

すべてのコマンドラインオプション、モジュール設定、ライブラリの使用方法については、Usageガイドを参照してください。

コンテナの使用方法

# 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トランスポートにはデフォルトで認証がありません。ループバック以外のアドレス（--host 0.0.0.0）にバインドすると、 認証なしのサーバーが公開され、そのポートに到達できる人は誰でもあなたのCrowdStrike 認証情報を使ってサーバーを操作できてしまいます。ローカル使用ではデフォルトのループバックバインドを維持し、より広い範囲にバインドする場合は必ず--api-keyを設定してください。 AWS Bedrock AgentCoreやGoogle Cloud Runなどのマネージドランタイムは独自のネットワーク セキュリティレイヤーの背後にあるため、これには該当しません。詳細については Configurationガイドを参照してください。

ローカルでのビルド、カスタムポート、高度な設定については、Docker Deploymentガイドを参照してください。

ダイナミックモード

多数のモジュールを同時に実行すると、すべてのAIクライアントが保持しなければならないコンテキストウィンドウが膨らみます。ダイナミックモードでは、 完全なツールサーフェスを3つのツールに置き換えます — サーバーが利用可能なすべてのツールを表示するfalcon_list_enabled_tools、キーワードで候補ツールを検索して選択したツールのパラメータ スキーマを取得するfalcon_search_tools、そしてツールを実行するfalcon_execute_toolです — これにより、エージェントは実際に必要なスキーマだけを読み込むことができます。

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

完全な「発見 → 実行」ワークフローとトレードオフについては、Dynamic Modeガイドを参照してください。

サーバーが実行できる操作の制限

--modulesはモジュール単位で全か無かです。1つのモジュールを有効にして検索ツールを取得すると、そのモジュールが持つすべての変更ツールも公開されます。3つのツールレベルのオプションで、そのサーフェスを絞り込めます。

# 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を使用します。4つのオプションはすべて組み合わせ可能で、固定された順序で解決されます：

1. --exclude-toolsは、--toolsで指定されていても、ツールを無条件に削除します。

2. --read-onlyは、--toolsで指定されていても、すべての変更ツールを無条件に削除します。

3. --toolsは、指定されたツールをモジュールのゲートを迂回して追加します。

4. --modulesは、デフォルトでどのツールが候補になるかを決定します。

最初の2つのルールが常に優先されるため、--read-onlyと--exclude-toolsはデプロイ全体の下限として安全に設定できます。追加的な--toolsリストはそれらを超えて拡大できません。これらを組み合わせることで、「すべてを検索し、何も変更せず、その1つのツールさえも提供しない」という設定を表現できます：

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

フィルタリングはダイナミックモードにも適用されます — 保留されたツールはfalcon_search_toolsの結果に含まれず、 falcon_execute_toolによって拒否されます。ダイナミックモードはツールを個別に登録するのではなく名前でディスパッチするため、 その拒否はツールが存在するがサーバーの設定がそれを保留していることを明示し、責任のある1つのルールを指名するため、 エージェントは「その機能は存在しない」とユーザーに伝える代わりに、無効なツールを無効として報告します。 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を使用しています。Contributing Guideに記載されているコミットメッセージ形式に従ってください。

開発者向けドキュメント

• Documentation Guide: ドキュメントのアーキテクチャとメンテナンスガイド

• Module Development Guide: 新しいモジュールを実装するための手順

• Resource Development Guide: リソースを実装するための手順

• Integration Testing Guide: 実際のAPI呼び出しを使用した統合テストを実行するためのガイド

レジストリ

falcon-mcpは、互換性のあるクライアントでの発見とワンクリックセットアップのために、公開MCPカタログに公開されています：

• MCP Registry

• GitHub MCP Registry

• Gemini CLI Extensions

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

サポート

これはコミュニティ主導のオープンソースプロジェクトです。CrowdStrikeの公式製品ではありませんが、CrowdStrikeによって積極的にメンテナンスされ、オープンソース開発者コミュニティとの連携でサポートされています。

詳細については、SUPPORTファイルを参照してください。