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

Этот сервер соединяет AI-ассистентов с VictoriaMetrics — системой мониторинга и observability. Он даёт языковым моделям прямой доступ к метрикам, логам, алертам и документации. Инженеры могут через естественный язык запрашивать данные, отлаживать конфигурации, исследовать кардинальность и выполнять read-only операции без ручного копания в API. Всё это ускоряет диагностику и автоматизацию прямо из чата.

Каталог MCP
VictoriaMetrics-Community/mcp-victoriametrics

VictoriaMetrics-Community/mcp-victoriametrics

от victoriametrics-community

MCP сервер для VictoriaMetrics: доступ к API и документации, выполнение PromQL/MetricsQL-запросов в реальном времени, анализ метрик, отладка relabeling и downsampling. Инструмент для инженеров по м...

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

README

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

Версии

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

VictoriaMetrics MCP Server

License

The implementation of Model Context Protocol (MCP) server for VictoriaMetrics.

This provides access to your VictoriaMetrics instance and seamless integration with VictoriaMetrics APIs and documentation. It can give you a comprehensive interface for monitoring, observability, and debugging tasks related to your VictoriaMetrics instances, enable advanced automation and interaction capabilities for engineers and tools.

Features

This MCP server allows you to use almost all read-only APIs of VictoriaMetrics, i.e. all functions available in VMUI:

Querying metrics and exploring data (even drawing graphs if your client supports it)
Listing and exporting available metrics, labels, labels values and entire series
Analyzing and testing your alerting and recording rules and alerts
Showing parameters of your VictoriaMetrics instance
Exploring cardinality of your data and metrics usage statistics
Analyzing, tracing, prettifying and explaining your queries
Debugging your relabeling rules, downsampling and retention policy configurations
Integration with VictoriaMetrics Cloud
UI with setup instrinctions and tools inspection on the root endpoint (only in Streamable HTTP mode)

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

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

Выберите клиент, чтобы установить VictoriaMetrics-Community/mcp-victoriametrics:

Любой клиент

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

{
  "mcpServers": {
    "victoriametrics-community-mcp-victoriame-bgec07gj02": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VM_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/mcp-victoriametrics"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
        "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "victoriametrics-community-mcp-victoriame-bgec07gj02": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VM_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/mcp-victoriametrics"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
        "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "victoriametrics-community-mcp-victoriame-bgec07gj02": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VM_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/mcp-victoriametrics"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
        "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"victoriametrics-community-mcp-victoriame-bgec07gj02\",\"type\":\"stdio\",\"command\":\"docker\",\"args\":[\"run\",\"-i\",\"--rm\",\"-e\",\"VM_INSTANCE_ENTRYPOINT\",\"-e\",\"VM_INSTANCE_TYPE\",\"-e\",\"VM_INSTANCE_BEARER_TOKEN\",\"-e\",\"VM_INSTANCE_HEADERS\",\"ghcr.io/victoriametrics/mcp-victoriametrics\"],\"env\":{\"VM_INSTANCE_ENTRYPOINT\":\"<YOUR_VM_INSTANCE>\",\"VM_INSTANCE_TYPE\":\"<YOUR_VM_INSTANCE_TYPE>\",\"VM_INSTANCE_BEARER_TOKEN\":\"<YOUR_VM_BEARER_TOKEN>\",\"VM_INSTANCE_HEADERS\":\"<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>\"}}"

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": {
    "victoriametrics-community-mcp-victoriame-bgec07gj02": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VM_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/mcp-victoriametrics"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
        "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

Claude Code

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

claude mcp add victoriametrics-community-mcp-victoriame-bgec07gj02 --env VM_INSTANCE_ENTRYPOINT=<YOUR_VM_INSTANCE> --env VM_INSTANCE_TYPE=<YOUR_VM_INSTANCE_TYPE> --env VM_INSTANCE_BEARER_TOKEN=<YOUR_VM_BEARER_TOKEN> --env VM_INSTANCE_HEADERS=<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE> -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VM_INSTANCE_HEADERS ghcr.io/victoriametrics/mcp-victoriametrics

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

claude mcp add-json victoriametrics-community-mcp-victoriame-bgec07gj02 "{\"command\":\"docker\",\"args\":[\"run\",\"-i\",\"--rm\",\"-e\",\"VM_INSTANCE_ENTRYPOINT\",\"-e\",\"VM_INSTANCE_TYPE\",\"-e\",\"VM_INSTANCE_BEARER_TOKEN\",\"-e\",\"VM_INSTANCE_HEADERS\",\"ghcr.io/victoriametrics/mcp-victoriametrics\"],\"env\":{\"VM_INSTANCE_ENTRYPOINT\":\"<YOUR_VM_INSTANCE>\",\"VM_INSTANCE_TYPE\":\"<YOUR_VM_INSTANCE_TYPE>\",\"VM_INSTANCE_BEARER_TOKEN\":\"<YOUR_VM_BEARER_TOKEN>\",\"VM_INSTANCE_HEADERS\":\"<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>\"}}"

Codex

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

codex mcp add victoriametrics-community-mcp-victoriame-bgec07gj02 --env VM_INSTANCE_ENTRYPOINT=<YOUR_VM_INSTANCE> --env VM_INSTANCE_TYPE=<YOUR_VM_INSTANCE_TYPE> --env VM_INSTANCE_BEARER_TOKEN=<YOUR_VM_BEARER_TOKEN> --env VM_INSTANCE_HEADERS=<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE> -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VM_INSTANCE_HEADERS ghcr.io/victoriametrics/mcp-victoriametrics

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

[mcp_servers.victoriametrics-community-mcp-victoriame-bgec07gj02]
command = "docker"
args = ["run", "-i", "--rm", "-e", "VM_INSTANCE_ENTRYPOINT", "-e", "VM_INSTANCE_TYPE", "-e", "VM_INSTANCE_BEARER_TOKEN", "-e", "VM_INSTANCE_HEADERS", "ghcr.io/victoriametrics/mcp-victoriametrics"]

[mcp_servers.victoriametrics-community-mcp-victoriame-bgec07gj02.env]
VM_INSTANCE_ENTRYPOINT = "<YOUR_VM_INSTANCE>"
VM_INSTANCE_TYPE = "<YOUR_VM_INSTANCE_TYPE>"
VM_INSTANCE_BEARER_TOKEN = "<YOUR_VM_BEARER_TOKEN>"
VM_INSTANCE_HEADERS = "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"

Perplexity

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

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

docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VM_INSTANCE_HEADERS ghcr.io/victoriametrics/mcp-victoriametrics

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

Windsurf

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

{
  "mcpServers": {
    "victoriametrics-community-mcp-victoriame-bgec07gj02": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VM_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/mcp-victoriametrics"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
        "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

Cline

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

{
  "mcpServers": {
    "victoriametrics-community-mcp-victoriame-bgec07gj02": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VM_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/mcp-victoriametrics"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
        "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: victoriametrics-community-mcp-victoriame-bgec07gj02
    command: docker
    args:
      - "run"
      - "-i"
      - "--rm"
      - "-e"
      - "VM_INSTANCE_ENTRYPOINT"
      - "-e"
      - "VM_INSTANCE_TYPE"
      - "-e"
      - "VM_INSTANCE_BEARER_TOKEN"
      - "-e"
      - "VM_INSTANCE_HEADERS"
      - "ghcr.io/victoriametrics/mcp-victoriametrics"
    env:
      VM_INSTANCE_ENTRYPOINT: <YOUR_VM_INSTANCE>
      VM_INSTANCE_TYPE: <YOUR_VM_INSTANCE_TYPE>
      VM_INSTANCE_BEARER_TOKEN: <YOUR_VM_BEARER_TOKEN>
      VM_INSTANCE_HEADERS: <HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>

Zed

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

{
  "context_servers": {
    "victoriametrics-community-mcp-victoriame-bgec07gj02": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VM_INSTANCE_HEADERS",
        "ghcr.io/victoriametrics/mcp-victoriametrics"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
        "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

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

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "VM_INSTANCE_ENTRYPOINT",
    "-e",
    "VM_INSTANCE_TYPE",
    "-e",
    "VM_INSTANCE_BEARER_TOKEN",
    "-e",
    "VM_INSTANCE_HEADERS",
    "ghcr.io/victoriametrics/mcp-victoriametrics"
  ],
  "env": {
    "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
    "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>",
    "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VM_BEARER_TOKEN>",
    "VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
  }
}