Graylog MCP Server

Graylog MCP服务器

引言

Graylog MCP服务器允许AI IDE和代理通过模型上下文协议安全地查询您的Graylog实例。它公开了标准化的工具，因此助手可以搜索最近或绝对的时间窗口，并可以在不提取全部有效载荷的情况下对结果进行计数。

您将获得：

• Graylog通用搜索的搜索工具

- 相对窗口：最后N秒 - 绝对窗口：显式ISO时间戳 - 仅统计轻量级分析的变体

• 流行IDE和MCP工具的插入式配置

要求：

• 一个灰色的URL
• 具有使用通用搜索权限的凭据

链接：

• 模型上下文协议：https://modelcontextprotocol.io
• Graylog：https://www.graylog.org/

______________________________________________________________________

安装和使用

快速启动（通过stdio运行MCP服务器）：

npx -y graylog-mcp

所需的环境变量：

• GRAYLOG_BASE_URL：您的GRAYLOG基本URL（例如。，https://graylog.example/)
• 灰色用户名：灰色用户名
• GRAYLOG密码：GRAYLOG密码

在您选择的IDE或代理工具（游标、VS代码、Claude代码）中配置：

{
  "graylog": {
    "command": "npx -y graylog-mcp",
    "env": {
      "GRAYLOG_BASE_URL": "https://YOUR_GRAYLOG_INSTANCE_URL/",
      "GRAYLOG_USERNAME": "YOUR_USERNAME",
      "GRAYLOG_PASSWORD": "YOUR_PASSWORD"
    }
  }
}

示例使用提示

充分利用MCP服务器的一些示例提示：

分析错误模式

search graylog for the errors in the past 24 hours with log_level:ERROR with a max limit of 100 per query

use the message patterns in the query results to figure out the patterns of errors that are occuring and put them in ERRORS.md

for subsequent queries, use the NOT condition to filter out messages with error patterns that are already discovered

安全注意事项：

• 更喜欢范围最小、权限最小的Graylog凭据。
• 不要将秘密交给源头控制；尽可能使用环境管理器。

______________________________________________________________________

贡献与地方发展

先决条件：

• 面包：https://bun.sh/
• 节点兼容环境

安装和构建：

# Install deps (if any) and build
bun install
bun run build

在本地运行（TypeScript直接通过Bun stdio）：

# Start the MCP server from source
export GRAYLOG_BASE_URL="https://your-graylog.example/"
export GRAYLOG_USERNAME="your-user"
export GRAYLOG_PASSWORD="your-password"
bun index.ts

对实时Graylog进行测试（验证通用搜索端点）：

export GRAYLOG_BASE_URL="https://your-graylog.example/"
export GRAYLOG_USERNAME="your-user"
export GRAYLOG_PASSWORD="your-password"

# Run verification (Bun executes TypeScript directly)
bun run test:graylog

项目脚本：

• 构建： bun run build → emits dist/index.js
• 测试： bun run test:graylog → 相对/绝对通用搜索的健康检查
• 显示包名称：打印包名称

使用MCP检查器对本地源进行调试：

npx -y @modelcontextprotocol/inspector "bun index.ts"

代码风格和贡献：

• 保持代码可读性和类型良好；避免不必要的复杂性。
• 匹配现有格式；保持线条合理包裹。
• 具有明确复制步骤或拟议变更的未决问题/PR。