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

Этот MCP-сервер соединяет AI-ассистентов с InfluxDB v2. Он позволяет умным инструментам читать данные из бакетов, выполнять Flux-запросы, записывать показатели в line protocol и управлять организациями с бакетами. Вместо того чтобы вручную ходить в консоль InfluxDB, разработчик поручает агенту всю рутину: мониторинг метрик, анализ временных рядов, настройку хранилищ. Всё — через единый протокол MCP.

Что он умеет?

Сервер работает с InfluxDB v2: записывает time-series данные в формате line protocol, выполняет Flux-запросы, чтобы проверять схемы измерений, делать агрегации и валидировать данные, читает списки организаций, бакетов и измерений внутри бакета. Управляет структурой базы: создаёт бакеты и организации. Ещё отдаёт шаблоны промптов с примерами Flux-запросов и разбором формата line protocol.

Каталог MCP
idoru/influxdb-mcp-server

idoru/influxdb-mcp-server

от idoru

MCP-сервер для доступа к InfluxDB v2. Позволяет AI агентам читать временные ряды, выполнять Flux-запросы и управлять объектами баз данных через ресурсы и инструменты. Упрощает интеграцию InfluxDB с...

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

README

4 инструмента

Версии

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

InfluxDB v2 MCP Server

A Model Context Protocol (MCP) server that exposes access to an InfluxDB v2 instance using the InfluxDB OSS API v2. Mostly built with Claude Code.

Features

This MCP server provides:

Resources: Access to organization, bucket, and measurement data
Tools: Write data, execute queries, and manage database objects
Prompts: Templates for common Flux queries and Line Protocol format

Resources

The server exposes the following resources:

Organizations List: influxdb://orgs
- Displays all organizations in the InfluxDB instance
Buckets List: influxdb://buckets
- Shows all buckets with their metadata
Bucket Measurements: influxdb://bucket/{bucketName}/measurements
- Lists all measurements within a specified bucket
Query Data: influxdb://query/{orgName}/{fluxQuery}
- Executes a Flux query and returns results as a resource

Tools

The server provides these tools:

write-data: Write time-series data in line protocol format
- Parameters: org, bucket, data, precision (optional)
query-data: Execute Flux queries
- Parameters: org, query
create-bucket: Create a new bucket
- Parameters: name, orgID, retentionPeriodSeconds (optional)
create-org: Create a new organization
- Parameters: name, description (optional)

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

Инструменты были проиндексированы: 21.10.2026

create-bucket

Создаёт новый бакет в организации, чтобы последующие вызовы write-data имели место назначения.

Параметры

namestringобязательный
Понятное имя bucket. Соблюдайте правила именования InfluxDB (буквы и цифры, дефисы, подчёркивания).
orgIDstringобязательный
Идентификатор организации (UUID), который будет владеть бакетом. Получите его из ресурса organizations или из вывода create-org.
retentionPeriodSecondsnumber
Необязательная продолжительность хранения в секундах. Опустите для бесконечного хранения.

create-org

Создаёт новую организацию для изоляции пользователей или проектов перед созданием bucket'ов и токенов.

Параметры

descriptionstring
Необязательное описание в свободной форме, которое помогает людям понять, зачем существует организация.
namestringобязательный
Отображаемое имя организации, как оно должно отображаться в InfluxDB Cloud/OSS.

query-data

Выполняет Flux-запрос внутри организации для проверки схем измерений, выполнения агрегаций или проверки недавно записанных данных.

Параметры

orgstringобязательный
Организация, чьи бакеты запрос должен нацеливать (точное имя, не ID).
querystringобязательный
Текст запроса Flux. Поддерживаются многострочные строки; результаты возвращаются в виде аннотированного CSV для удобного разбора.

write-data

Потоковая запись записей протокола строк с разделителями новой строки в bucket. Используйте это после составления измерений, чтобы LLM могла вставлять реальную телеметрию, с возможностью управления точностью временных меток.

Параметры

bucketstringобязательный
Имя корзины для получения очков. Убедитесь, что она уже существует, или сначала вызовите create-bucket.
datastringобязательный
Полезная нагрузка, содержащая одну или несколько строк протокола line protocol (измерения, теги, поля, временные метки), разделенных переводами строк.
orgstringобязательный
Человекочитаемое название организации, которой принадлежит целевой бакет (то же значение, которое возвращает ресурс orgs).
precisionenum
Необязательная точность временной метки. Указывайте её только когда строчный протокол опускает контекст суффикса единицы измерения; по умолчанию — наносекунды.

`0.2.0`основная	17.11.2025
`0.1.1`	11.03.2025
`0.1.0`	11.03.2025

Выберите клиент, чтобы установить idoru/influxdb-mcp-server:

Любой клиент

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

{
  "mcpServers": {
    "idoru-influxdb-mcp-server-y9amqy7gy5": {
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "idoru-influxdb-mcp-server-y9amqy7gy5": {
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "idoru-influxdb-mcp-server-y9amqy7gy5": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"idoru-influxdb-mcp-server-y9amqy7gy5\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"influxdb-mcp-server\"],\"env\":{\"INFLUXDB_TOKEN\":\"your_token\",\"INFLUXDB_URL\":\"http://localhost:8086\",\"INFLUXDB_ORG\":\"your_org\"}}"

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": {
    "idoru-influxdb-mcp-server-y9amqy7gy5": {
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Claude Code

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

claude mcp add idoru-influxdb-mcp-server-y9amqy7gy5 --env INFLUXDB_TOKEN=your_token --env INFLUXDB_URL=http://localhost:8086 --env INFLUXDB_ORG=your_org -- npx influxdb-mcp-server

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

claude mcp add-json idoru-influxdb-mcp-server-y9amqy7gy5 "{\"command\":\"npx\",\"args\":[\"influxdb-mcp-server\"],\"env\":{\"INFLUXDB_TOKEN\":\"your_token\",\"INFLUXDB_URL\":\"http://localhost:8086\",\"INFLUXDB_ORG\":\"your_org\"}}"

Codex

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

codex mcp add idoru-influxdb-mcp-server-y9amqy7gy5 --env INFLUXDB_TOKEN=your_token --env INFLUXDB_URL=http://localhost:8086 --env INFLUXDB_ORG=your_org -- npx influxdb-mcp-server

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

[mcp_servers.idoru-influxdb-mcp-server-y9amqy7gy5]
command = "npx"
args = ["influxdb-mcp-server"]

[mcp_servers.idoru-influxdb-mcp-server-y9amqy7gy5.env]
INFLUXDB_TOKEN = "your_token"
INFLUXDB_URL = "http://localhost:8086"
INFLUXDB_ORG = "your_org"

Perplexity

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

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

npx influxdb-mcp-server

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

Windsurf

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

{
  "mcpServers": {
    "idoru-influxdb-mcp-server-y9amqy7gy5": {
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Cline

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

{
  "mcpServers": {
    "idoru-influxdb-mcp-server-y9amqy7gy5": {
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: idoru-influxdb-mcp-server-y9amqy7gy5
    command: npx
    args:
      - "influxdb-mcp-server"
    env:
      INFLUXDB_TOKEN: your_token
      INFLUXDB_URL: http://localhost:8086
      INFLUXDB_ORG: your_org

Zed

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

{
  "context_servers": {
    "idoru-influxdb-mcp-server-y9amqy7gy5": {
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

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

{
  "command": "npx",
  "args": [
    "influxdb-mcp-server"
  ],
  "env": {
    "INFLUXDB_TOKEN": "your_token",
    "INFLUXDB_URL": "http://localhost:8086",
    "INFLUXDB_ORG": "your_org"
  }
}

Нужен npx

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

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