How kitproj/splunk-cli works
Splunk CLI & MCP Server provides two user-facing entry points for searching Splunk: a command-line command and an MCP tool over stdio. Both create a search job, poll its status, retrieve results, and format them for the caller. CLI configuration stores the host in a config file and the token in the system keyring; the README also documents environment-variable fallback for CLI use. The client implements additional saved-search, alert, server-info, and event operations, but no sampled caller connects these to a user-facing route. The MCP server's sampled configuration path uses config and keyring; its documented environment fallback is not visible in that implementation.
Main entry points: main.go CLI Commands · mcp.go MCP Server · client.go Search Jobs · config.go Host Config
Components 18
User Entry Points
- CLI Commands
main.go - MCP Server
mcp.go - MCP Search Tool
mcp.go
Search Execution
- CLI Search
main.go - MCP Search Handler
mcp.go
Credentials and Config
- Configure Credentials
main.go - Host Config
internal/config/config.go - Token Keyring
internal/config/config.go
Splunk API
- Search Jobs
internal/splunk/client.go - Search Status
internal/splunk/client.go - Search Results
internal/splunk/client.go - Saved Searches
internal/splunk/client.go - Scheduled Alerts
internal/splunk/client.go - Server Info
internal/splunk/client.go - Event Collector
internal/splunk/client.go
Other components
- CLI User
- MCP Client
- Splunk Instance
Connections 26
- CLI User → CLI Commands: runs commands
README.md - CLI Commands → Configure Credentials: dispatches configure
main.go - CLI Commands → CLI Search: dispatches search
main.go - CLI Commands → MCP Server: dispatches server
main.go - MCP Client → MCP Server: starts stdio
README.md - MCP Server → MCP Search Tool: registers tool
mcp.go - MCP Search Tool → MCP Search Handler: invokes handler
mcp.go - Configure Credentials → Host Config: saves host
main.go - Configure Credentials → Token Keyring: saves token
main.go - CLI Commands → Host Config: loads host
main.go - CLI Commands → Token Keyring: loads token
main.go - MCP Server → Host Config: loads host
mcp.go - MCP Server → Token Keyring: loads token
mcp.go - CLI Search → Search Jobs: creates job
main.go - CLI Search → Search Status: polls status
main.go - CLI Search → Search Results: fetches results
main.go - MCP Search Handler → Search Jobs: creates job
mcp.go - MCP Search Handler → Search Status: polls status
mcp.go - MCP Search Handler → Search Results: fetches results
mcp.go - Search Jobs → Splunk Instance: submits search
internal/splunk/client.go - Search Status → Splunk Instance: queries status
internal/splunk/client.go - Search Results → Splunk Instance: fetches results
internal/splunk/client.go - Saved Searches → Splunk Instance: manages searches
internal/splunk/client.go - Scheduled Alerts → Splunk Instance: lists alerts
internal/splunk/client.go - Server Info → Splunk Instance: queries info
internal/splunk/client.go - Event Collector → Splunk Instance: sends events
internal/splunk/client.go