convez.ai
MCP ServerDados & AnalyticsAvançado
dd-Splunk

Splunk MCP Server em Docker

dd-Splunk/splunk-mcp

Conecte Splunk Enterprise a agentes de IA via MCP em Docker

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra Splunk Enterprise com Claude, Cursor e Goose através de MCP-remote. Fornece acesso programático às capacidades de busca, análise e visualização do Splunk para agentes de IA, incluindo dados de exemplo Splunk4Rookies e gerenciamento de segredos via 1Password ou .env.

Instalação

$npx convez-ai dd-Splunk/splunk-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 2 semanas
Versão
latest
Issues abertas
0
Contribuidores
3

Casos de uso

  • Automatizar buscas e análises Splunk através de agentes de IA
  • Integrar dados do Splunk em fluxos de trabalho Claude/Cursor
  • Demonstrações interativas de análise de dados com IA

Veredito

Prova de conceito robusta para integração Splunk+IA em ambiente local. Exige conhecimento de Docker, secrets management e MCP; ideal para SE/presales que precisam demonstrar capacidades agentic em dados corporativos.

README

A tradução para o português deste README ainda está na fila.

splunk-mcp

Local proof-of-concept: run Splunk Enterprise in Docker with the Splunk MCP Server app, and connect Cursor, Claude Desktop, or Goose via npx mcp-remote (Splunk 1.2 canonical config). Includes Splunk4Rookies sample data (SA-S4R) and an optional Marp presenter deck in demo-slides/ (make marp-preview). Secrets come from the 1Password CLI (op + tpl.env) or a git-ignored .env (no 1Password required).

First time here? (Presales / SE demo)

  1. Read docs/PRESALES.md end-to-end—it is the demo runbook (secrets, time budget, Cursor-first steps, checklist, handoff).
  2. Copy tpl.env.example → tpl.env and fix every op:// path, or copy .env.example → .env and fill plain values (see PRESALES Path A / Path B).
  3. Run make up (updates Claude, Cursor, and Goose configs), restart clients as needed, then make verify-mcp-remote.

Presenting the agentic Buttercup demo? Install Marp CLI, then make marp-preview or make marp-serve — see Splunk4Rookies presenter deck (Marp) and demo-slides/README.md.

Do not block a live meeting on a cold start: first make up can take many minutes (pulls, Splunk, Splunkbase apps, init).

What you get

EndpointUse
https://localhost:8000Splunk Web
https://localhost:8089/services/mcpSplunk MCP Server (npx mcp-remote + token in client config only)

Splunkbase apps (see compose.yml for IDs, including Splunk MCP Server) install at container start. A one-shot init configures MCP for local dev and creates/updates user splunker (role mcp_user, capability **mcp_tool_execute). make up waits for splunk-init, mints tokens, and updates Claude, Cursor, and Goose (tokens stay out of git).

Not included in init: a claude_logs index or file monitors. Optional ingestion is described in docs/CONFIGURATION.md if you uncomment the bind mount in compose.yml.

Also in this repo: SA-S4R Eventgen traffic, multi-agent Cursor prompts (.cursor/agents/), and the Marp slide deck — presenter deck (Marp) · docs/s4r/README.md.

Requirements

  • Docker with Compose, make, bash, curl, jq
  • Secrets: 1Password + tpl.env or .env (see docs/PRESALES.md)
  • Node / npm for npx mcp-remote (all MCP clients)
  • Splunkbase account with download rights (used for SPLUNK_APPS_URL)

Quick commands

make up                      # start stack, update all MCP clients
make status                  # is Splunk answering?
make update-mcp-client MCP_CLIENT=cursor   # one client
make verify-mcp-remote       # verify all clients + Splunk MCP API (default)
make down                    # stop (no op / .env needed)
CommandPurpose
make helpAll targets
make upCompose up, then update-mcp-clients
make update-mcp-clientsUpdate Claude, Cursor, and Goose configs
make update-mcp-clientOne client (MCP_CLIENT=claude|cursor|goose)
make verify-mcp-remoteConfig check + Splunk MCP tools/list (MCP_VERIFY_CLIENT=all default)
make cleanDestructive: volumes + .env (prompts; no op needed)

Splunk4Rookies presenter deck (Marp)

Optional 17-slide deck for the agentic Buttercup demo (demo-slides/s4r-demo-slides.md). Not required to run the Splunk stack.

Dependencies: Marp CLI on PATH (npm install -g @marp-team/marp-cli or brew install marp-cli). Live preview/serve loads Mermaid from jsDelivr at view time (network needed unless you use exported HTML). Optional in-editor preview: Marp for VS Code.

make marp-preview    # preview window
make marp-serve      # http://localhost:8080/
make marp-html       # export demo-slides/s4r-demo-slides.html

Presenter script: demo-slides/S4R-DEMO.md. Build, theme, Mermaid, troubleshooting: demo-slides/README.md.

Documentation (by audience)

DocAudience
docs/PRESALES.mdSE / presales: demo prep and flow
docs/s4r/README.mdSplunk4Rookies workshop hub
demo-slides/README.mdMarp deck (deps, theme, make marp-*)
docs/INSTALLATION.mdDetailed install and verification
docs/ARCHITECTURE.mdArchitecture and stack flow
docs/CONFIGURATION.mdcompose.yml, env files, client configs
docs/TROUBLESHOOTING.mdFailures: Splunkbase, ports, token, MCP
docs/README.mdFull documentation index
AGENTS.mdContributors and AI agent rules

Security

Local development defaults: self-signed TLS, dev-oriented MCP settings, secrets in op / .env. Do not expose this stack to untrusted networks as-is. See docs/SECURITY.md.

CI

Pushes/PRs to main / master: .github/workflows/ci.yml runs pre-commit (shellcheck + markdownlint). One-time setup: pip install pre-commit && pre-commit install. Check all files: pre-commit run --all-files.

Repository layout (high level)

splunk-mcp/
├── compose.yml                         # Splunk + one-shot init
├── Makefile
├── tpl.env.example / .env.example     # Tracked; copy to tpl.env or .env (gitignored)
├── scripts/                            # compose-up, setup-splunk, mint-mcp-token, mcp-client
├── SA-S4R/                             # Sample app (Eventgen)
├── demo-slides/                        # Marp presenter deck (see demo-slides/README.md)
└── docs/

Behavior: Makefile, compose.yml, scripts/compose-up.sh, scripts/setup-splunk.sh. License: LICENSE (MIT).

Ver o original no GitHub

Bom para

Relacionados