Для чего этот сервер?

Этот MCP-сервер соединяет ИИ-ассистента с Grafana Loki и даёт ему возможность напрямую запрашивать логи, получать метки и читать результаты в удобном формате. Разработчикам и инженерам больше не нужно переключаться между инструментами — можно анализировать логи, искать ошибки и смотреть тренды прямо из чата.

Каталог MCP
tumf/grafana-loki-mcp

tumf/grafana-loki-mcp

от tumf

MCP сервер для запросов логов из Grafana Loki: позволяет выполнять LogQL-запросы, получать метки и значения, форматировать результаты. Полезен разработчикам и DevOps для анализа логов через MCP-инструменты.

Github PyPi Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

Grafana-Loki MCP Server

A FastMCP server that allows querying Loki logs from Grafana.

MCP Server Settings

{
  "mcpServers": {
    "loki": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

GRAFANA_URL: URL of your Grafana instance
GRAFANA_API_KEY: Grafana API key with appropriate permissions

Features

Query Loki logs through Grafana API
Get Loki labels and label values
Format query results in different formats (text, JSON, markdown)
Support for both stdio and SSE transport protocols

Requirements

Python 3.10+
FastMCP
Requests

Installation

Using pip

pip install grafana-loki-mcp

Development Setup

Clone this repository
Install dependencies using uv:

# Install uv
pip install uv

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e ".[dev]"

Usage

Environment Variables

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

`0.1.4`основная	19.06.2025
`0.1.5b2`	30.06.2025
`0.1.4b7`	19.06.2025
`0.1.4b9`	18.06.2025
`0.1.4b8`	18.06.2025
`0.1.4b6`	31.05.2025
`0.1.4b5`	27.05.2025
`0.1.4b4`	02.05.2025
`0.1.4b3`	22.04.2025
`0.1.4b0`	08.04.2025
`0.1.3b0`	08.04.2025
`0.1.3`	06.04.2025
`0.1.2b0`	31.03.2025
`0.1.2`	12.03.2025
`0.1.1`	12.03.2025

Выберите клиент, чтобы установить tumf/grafana-loki-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "tumf-grafana-loki-mcp-y8luzzszp2": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "tumf-grafana-loki-mcp-y8luzzszp2": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "tumf-grafana-loki-mcp-y8luzzszp2": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"tumf-grafana-loki-mcp-y8luzzszp2\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"grafana-loki-mcp\",\"-u\",\"GRAFANA_URL\",\"-k\",\"GRAFANA_API_KEY\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "tumf-grafana-loki-mcp-y8luzzszp2": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add tumf-grafana-loki-mcp-y8luzzszp2 -- uvx grafana-loki-mcp -u GRAFANA_URL -k GRAFANA_API_KEY

Либо через JSON-конфиг:

claude mcp add-json tumf-grafana-loki-mcp-y8luzzszp2 "{\"command\":\"uvx\",\"args\":[\"grafana-loki-mcp\",\"-u\",\"GRAFANA_URL\",\"-k\",\"GRAFANA_API_KEY\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add tumf-grafana-loki-mcp-y8luzzszp2 -- uvx grafana-loki-mcp -u GRAFANA_URL -k GRAFANA_API_KEY

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.tumf-grafana-loki-mcp-y8luzzszp2]
command = "uvx"
args = ["grafana-loki-mcp", "-u", "GRAFANA_URL", "-k", "GRAFANA_API_KEY"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите tumf/grafana-loki-mcp, а в поле команды запуска — строку ниже:

uvx grafana-loki-mcp -u GRAFANA_URL -k GRAFANA_API_KEY

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "tumf-grafana-loki-mcp-y8luzzszp2": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "tumf-grafana-loki-mcp-y8luzzszp2": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например tumf-grafana-loki-mcp-y8luzzszp2.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: tumf-grafana-loki-mcp-y8luzzszp2
    command: uvx
    args:
      - "grafana-loki-mcp"
      - "-u"
      - "GRAFANA_URL"
      - "-k"
      - "GRAFANA_API_KEY"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "tumf-grafana-loki-mcp-y8luzzszp2": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "grafana-loki-mcp",
    "-u",
    "GRAFANA_URL",
    "-k",
    "GRAFANA_API_KEY"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #195
Звезд на Github: 29
Форков на Github: 6
Загрузок: 5 197
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 11:10
Идентификатор: cfZHwZTQxTYHIyN_
Категории: Инструменты для разработчиков, Мониторинг

Похожие MCP-сервера

Grafana MCP

официальный

от grafana

MCP сервер для интеграции с Grafana: управляйте дашбордами, выполняйте запросы к Prometheus, Loki, CloudWatch и другим источникам через MCP. Упрощает мониторинг, анализ метрик и логов — полезен для инженеров и DevOps.

alimuratkuslu/byok-observability-mcp

от alimuratkuslu

MCP сервер для запросов к observability-стекам (Grafana, Prometheus, Kafka UI, Datadog). Данные хранятся локально — ключи не покидают машину. Разработчики и SRE анализируют метрики, алерты и логи прямо из Claude Code, Codex или любого MCP клиента без настройки инфраструктуры.

pab1it0/prometheus-mcp-server

от pab1it0

MCP-сервер для прямого доступа к метрикам Prometheus. Позволяет AI-ассистентам выполнять PromQL-запросы, просматривать список метрик и получать их метаданные. Полезен инженерам, работающим с observ...

VictoriaMetrics-Community/mcp-victorialogs

официальный

от victoriametrics-community

MCP-сервер для VictoriaLogs. Предоставляет AI-агентам доступ к чтению логов, метрик, полей и встроенной документации через LogsQL-запросы. Упрощает отладку и мониторинг для инженеров.

rrmistry/tilt-mcp

от rrmistry

Интегрирует Tilt с LLM-ассистентами (Claude, Copilot). Предоставляет доступ к ресурсам, логам и статусу сервисов, а также управляет сборкой и мониторингом. Идеально для разработчиков, автоматизирую...

last9/last9-mcp-server

официальный

от last9

Last9 MCP-сервер подключает AI-агентов (Claude, Cursor, Windsurf) к вашим производственным данным observability — логам, метрикам, трейсам, алертам. Без установки бинарников, через OAuth. Полезен S...