Splunk查询服务器

一个提供AI代理查询和交互Splunk实例的模型上下文协议(MCP)服务器,通过安全API连接实现与Splunk数据的自然语言交互。

  • by darwineee
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 darwineee/splunk-mcp

使用说明

Splunk MCP服务器

模型上下文协议(MCP)服务器,为AI代理提供查询Splunk实例并与之交互的能力。该服务器通过安全的API连接实现与Splunk数据的自然语言交互。

特性

  • Splunk查询执行:使用可自定义的时间范围运行SPL(搜索处理语言)查询
  • 灵活的身份验证:支持基于令牌和用户名/密码的身份验证
  • 健康监测:内置健康检查端点

可用工具

run_splunk_query

执行Splunk搜索查询并检索结果。

参数:

  • query (str):要运行的Splunk搜索查询
  • earliest_time (str,可选):搜索的最早时间(默认值:“-24h”)
  • latest_time (str,可选):搜索的最新时间(默认值:“现在”)

退货: 搜索结果列表,包括数据和任何消息/警告

get_indexes

列出所有可访问的Splunk索引。

退货: 配置用户可用的索引名称列表

安装

  1. 克隆此存储库:
git clone <repository-url>
cd Splunk-MCP
  1. 安装所需的依赖项:
pip install -r requirements.txt

配置

创建一个 .env 使用Splunk配置在项目根目录中创建文件:

基于令牌的身份验证(推荐)

SPLUNK_HOST=your-splunk-host.com
SPLUNK_PORT=8089
SPLUNK_PROTOCOL=https
SPLUNK_TOKEN=your-splunk-token

用户名/密码验证

SPLUNK_HOST=your-splunk-host.com
SPLUNK_PORT=8089
SPLUNK_PROTOCOL=https
SPLUNK_USERNAME=your-username
SPLUNK_PASSWORD=your-password

配置选项

变量 描述 默认值
SPLUNK_HOST Splunk服务器主机名 localhost
SPLUNK_PORT Splunk管理端口 8089
SPLUNK_PROTOCOL 连接协议(http/https) https
SPLUNK_TOKEN 身份验证令牌(首选) 无
SPLUNK_USERNAME 基本身份验证的用户名 无
SPLUNK_PASSWORD 基本身份验证密码 无

用法

启动服务器

运行MCP服务器:

python main.py

服务器将于启动 http://0.0.0.0:8081 使用服务器发送事件(SSE)传输。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。