⚠️ 本项目已归档——请使用官方的 Splunk MCP 服务器

感谢所有使用、点星和分叉本项目的人！ 🙏 它最初是社区推动的，旨在引入模型上下文协议（MCP） 对 Splunk 的支持，远在官方选项出现之前。

Splunk 现在发布了一个第一方、完全支持的 MCP 服务器，并且已经不断扩展 超出本社区项目所提供的范围。请迁移到官方服务器：

• 📦 Splunk MCP 服务器在 Splunkbase 上（应用 7931，由 Splunk LLC 开发）: https://splunkbase.splunk.com/app/7931
• 📖 Docs — Splunk 平台 MCP 服务器： https://help.splunk.com/en/splunk-cloud-platform/mcp-server-for-splunk-platform/

本仓库现为只读/存档，将不再接收 更新。以下代码被保留以供历史参考。再次感谢！🚀

---

Splunk MCP（模型上下文协议）工具

基于FastMCP的工具，通过自然语言与Splunk Enterprise/Cloud交互。该工具提供一套功能，用于搜索Splunk数据、管理KV存储以及通过直观界面访问Splunk资源。

操作模式

该工具有三种工作模式：

⚠️ This project is archived — use the official Splunk MCP Server

Thank you to everyone who used, starred, and forked this project! 🙏 It started as a community effort to bring Model Context Protocol (MCP) support to Splunk, well before an official option existed.

Splunk now ships a first-party, fully supported MCP server that has grown beyond what this community project provides. Please migrate to the official server:

• 📦 Splunk MCP Server on Splunkbase (App 7931, by Splunk LLC): https://splunkbase.splunk.com/app/7931
• 📖 Docs — MCP Server for Splunk Platform: https://help.splunk.com/en/splunk-cloud-platform/mcp-server-for-splunk-platform/

This repository is now read-only / archived and will no longer receive updates. The code below is preserved for historical reference. Thanks again! 🚀

---

Splunk MCP (Model Context Protocol) Tool

A FastMCP-based tool for interacting with Splunk Enterprise/Cloud through natural language. This tool provides a set of capabilities for searching Splunk data, managing KV stores, and accessing Splunk resources through an intuitive interface.

Operating Modes

The tool operates in three modes:

1. SSE Mode (Default)

   • Server-Sent Events based communication
   • Real-time bidirectional interaction
   • Suitable for web-based MCP clients
   • Default mode when no arguments provided
   • Access via /sse endpoint

2. API Mode

   • RESTful API endpoints
   • Access via /api/v1 endpoint prefix
   • Start with python splunk_mcp.py api

3. STDIO Mode

   • Standard input/output based communication
   • Compatible with Claude Desktop and other MCP clients
   • Ideal for direct integration with AI assistants
   • Start with python splunk_mcp.py stdio

Features

• Splunk Search: Execute Splunk searches with natural language queries
• Index Management: List and inspect Splunk indexes
• User Management: View and manage Splunk users
• KV Store Operations: Create, list, and manage KV store collections
• Async Support: Built with async/await patterns for better performance
• Detailed Logging: Comprehensive logging with emoji indicators for better visibility
• SSL Configuration: Flexible SSL verification options for different security requirements
• Enhanced Debugging: Detailed connection and error logging for troubleshooting
• Comprehensive Testing: Unit tests covering all major functionality
• Error Handling: Robust error handling with appropriate status codes
• SSE Compliance: Fully compliant with MCP SSE specification

Available MCP Tools

The following tools are available via the MCP interface:

Tools Management

• list_tools
  • Lists all available MCP tools with their descriptions and parameters

Health Check

• health_check
  • Returns a list of available Splunk apps to verify connectivity
• ping
  • Simple ping endpoint to verify MCP server is alive

User Management