dannyota/splunkctl

Splunk Enterprise および Splunk SOAR は、人間やAI エージェントのセキュリティファーストの CLI サーバと MCP サーバーのコードとして認証します。

ドキュメント・コマンドカタログ・リリース

お問い合わせ

[splunkctl はオープンソースの Python CLI で、 モデル コンテキスト プロトコル (MCP) サーバー リモート Splunk 企業と Splunk SOAR インスタンス。 相互に使用して下さい、 安定した JSON 出力をスクリプトしたり、MCP クライアントが同じコマンドにアクセスしたりする 表面。

-Splunk Enterpriseの管理 — 検索、検出ルール、アラート、インデックス、 入力、検索、パーサ、ダッシュボード、アプリ、ユーザー、トポロジー、監査、および 企業セキュリティワークフロー。

• 優れたスプランクSOAR — コンテナ、アーティファクト、 Playbook、アクション、ケース、 承認、資産、保管庫ファイル、カスタムリスト、管理、SIEM-to-SOAR インジェスト
• コードとしてのKeep構成 — ライブ状態をプルし、構造ドリフトを見直し、 変更証拠レポートで承認された変更を押します。
• 安全に自動化 — デフォルトで変異プレビュー、機械出力は 構造化、エラーはタイプされ、すべてのターゲットプロファイルとホストが表示されます。

すべてのミューテーションはデフォルトでドライランです。 通過するまでの変更はありません [--yes]。 ターゲットを見直し、適用する前に変更を提案しました.

---

splunkctl is an open-source Python CLI and Model Context Protocol (MCP) server for remote Splunk Enterprise and Splunk SOAR instances. Use it interactively, script its stable JSON output, or give an MCP client access to the same command surface.

• Manage Splunk Enterprise — searches, detection rules, alerts, indexes, inputs, lookups, parsers, dashboards, apps, users, topology, audit, and Enterprise Security workflows.
• Operate Splunk SOAR — containers, artifacts, playbooks, actions, cases, approvals, assets, vault files, custom lists, administration, and SIEM-to-SOAR ingest.
• Keep configuration as code — pull live state, review structured drift, and push approved changes with change-evidence reports.
• Automate safely — mutations preview by default, machine output is structured, errors are typed, and every target profile and host is shown.

Every mutation is a dry run by default. Nothing changes until you pass --yes. Review the target and proposed change before applying it.

Install

python -m pip install splunkctl

Python 3.13 or newer is required. Core commands work with the upstream Splunk SDK installed from PyPI.

Dashboard, lookup-file, and HTTP Event Collector (HEC) token commands use entity classes provided by the optional splunkctl SDK fork:

python -m pip install git+https://github.com/dannyota/splunk-sdk-python@splunkctl

See the installation guide for environment-specific setup.

Quickstart

# Configure and verify Splunk Enterprise
splunkctl config init
splunkctl doctor

# Read live state
splunkctl info
splunkctl search run 'index=main | head 10'
splunkctl rules list --json

# Preview a change; add --yes only after reviewing it
splunkctl rules disable 'My Rule'

# Add and verify Splunk SOAR when needed
splunkctl config init --soar