graylog-mcp

alex-kish/graylog-mcp

3.1

If you are the rightful owner of graylog-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Graylog MCP Server is a tool designed to work with the Graylog API, providing log analysis and error monitoring capabilities post-release.

Tools
2
Resources
0
Prompts
0

Graylog MCP Server

MCP сервер для работы с Graylog API. Предоставляет инструменты для анализа логов и мониторинга ошибок после релизов.

Возможности

Tools (Инструменты)

  • graylog_search_by_trace_id - Поиск и анализ логов по trace_id для диагностики ошибок
  • graylog_release_monitor - Мониторинг ошибок после релиза, поиск новых ошибок и анализ роста существующих

Параметры graylog_search_by_trace_id:

  • trace_id - ID трейса для поиска связанных логов (например, '0bd57cbd7bd485befca4b568f813d860')

Параметры graylog_release_monitor:

  • release_time - Время релиза в формате 'YYYY-MM-DD HH:MM[:SS]' (UTC timezone)
  • webapp_environment - Окружение релиза (sandbox, test, u3-1, u3-2, u3-3, u3-4)
  • facility - Фильтр приложения (по умолчанию: webapp* для всех webapp приложений)

Настройка

Переменные окружения для Graylog

Создай файл .env или экспортируй переменные:

export GRAYLOG_HOST=localhost          # Адрес Graylog сервера
export GRAYLOG_PORT=9000              # Порт Graylog API
export GRAYLOG_USERNAME=admin         # Пользователь Graylog
export GRAYLOG_PASSWORD=admin         # Пароль Graylog

По умолчанию используются значения для локального Graylog.

Установка

  1. Клонируй репозиторий:
git clone https://github.com/alex-kish/graylog-mcp.git
cd graylog-mcp
  1. Установи зависимости через uv (рекомендуется):
brew install uv  # macOS

# установить зависимости
uv sync

# запуск сервера
uv run python -m graylog_mcp.cli
  1. Альтернативно через pip:
pip install -e .
graylog-mcp-server
  1. Протестируй сервер:
uv run python -c "from graylog_mcp import create_server; print('✅ Сервер работает')"

Настройка в Cursor

  1. Открой настройки Cursor: Cmd + Shift + J (macOS) или Ctrl + Shift + J (Windows/Linux)

  2. Перейди на вкладку "MCP"

  3. Добавь новый сервер в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "graylog-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/полный/путь/к/graylog-mcp",
        "run",
        "python",
        "-m",
        "graylog_mcp.cli"
      ],
      "env": {
        "GRAYLOG_HOST": "https://your-graylog-host.com",
        "GRAYLOG_PORT": "9000",
        "GRAYLOG_USERNAME": "your-username",
        "GRAYLOG_PASSWORD": "your-password"
      }
    }
  }
}

Или используй содержимое cursor_mcp_config.json как шаблон

  1. Перезапусти Cursor

Использование

После настройки попроси Claude в Cursor:

Анализ ошибок по trace_id:

  • "Проанализируй ошибку с trace_id: 0bd57cbd7bd485befca4b568f813d860"
  • "Найди все логи связанные с trace_id: d22a5f021105aa8b8d41147c6040a229"

Мониторинг после релиза:

  • "Запусти мониторинг ошибок после релиза сегодня в 14:00 на стенде u3-1"
  • "Проверь новые ошибки после релиза 2025-01-22 18:00 на sandbox"
  • "Мониторинг релиза вчера в 12:30 на test окружении для webapp/api"

Примеры команд

Поиск по trace_id:

"Вот trace_id ошибки 0bd57cbd7bd485befca4b568f813d860, проанализируй в чем проблема"

Мониторинг релиза:

"Запусти мониторинг ошибок в грейлоге, релиз был сегодня в 18:00 на стенде u3-1"

Структура проекта

graylog-mcp/
├── graylog_mcp/
│   ├── __init__.py      # Основные экспорты
│   ├── cli.py           # CLI точка входа
│   ├── server.py        # MCP сервер конфигурация
│   └── tools.py         # Инструменты для работы с Graylog
├── pyproject.toml       # Конфигурация проекта и зависимости
├── uv.lock             # Lockfile зависимостей
└── README.md           # Документация