dannyota/splunkctl

Splunk Enterprise 및 Splunk SOAR 코드로 인간 및 AI 에이전트에 대한 안전 우선 CLI 및 MCP 서버.

문서 · 명령 카탈로그 · 릴리즈

---

splunkctl 오픈소스 Python CLI 및 모델 Context Protocol (MCP) 서버 원격 Splunk Enterprise 및 Splunk SOAR 인스턴스. 그것을 상호 작용하게 사용하십시오, 안정적인 JSON 출력을 스크립트, 또는 MCP 클라이언트 액세스를 동일한 명령에 제공합니다. 지상.

-Manage Splunk Enterprise - 검색, 탐지 규칙, 경고, 인덱스, 입력, 조회, 파서, 대쉬보드, 앱, 사용자, 토폴로지, 감사 및 Enterprise 보안 워크플로우. -Operate Splunk SOAR — 컨테이너, artifacts, playbooks, 작업, 케이스, 승인, 자산, vault 파일, 사용자 정의 목록, 관리 및 SIEM-to-SOAR 뚱 베어 -Keep configuration as code — 풀 라이브 상태, 구조화된 드리프트, 그리고 변경 증거 보고서로 승인된 변경을 푸시 합니다.

• **Automate는 ** - 기본으로 mutations 미리보기, 기계 출력 구조화, 오류가 입력되고, 모든 타겟 프로파일과 호스트가 표시됩니다.

모든 돌연변이는 기본적으로 건조한 달립니다. 당신이 통과 할 때까지 아무것도 변경 --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