Каталог MCP
InfluxData/influxdb3_mcp_server

InfluxData/influxdb3_mcp_server

MCP сервер для InfluxDB 3: SQL-запросы, запись line protocol, управление базами и токенами. Более 20 инструментов для Core, Enterprise, Cloud. Незаменим для инженеров данных и DevOps, работающих с ...

README

27 инструментов

Версии

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

InfluxDB MCP Server

Model Context Protocol (MCP) server for InfluxDB 3 integration. Provides tools, resources, and prompts for interacting with InfluxDB v3 (Core/Enterprise/Cloud Dedicated/Clustered/Cloud Serverless) via MCP clients.

Prerequisites

InfluxDB 3 Instance: URL and token (Core/Enterprise/Cloud Serverless) or Cluster ID and tokens (Cloud Dedicated/Clustered)
Node.js: v20.11 or newer (for npm/npx usage)
npm: v9 or newer (for npm/npx usage)
Docker: (for Docker-based setup)

Available Tools

Tool Name	Description	Availability
`load_database_context`	Load optional custom database context and documentation	All versions
`get_help`	Get help and troubleshooting guidance for InfluxDB operations	All versions
`write_line_protocol`	Write data using InfluxDB line protocol	All versions
`create_database`	Create a new database (with cloud-specific config options)	All versions
`update_database`	Update database configuration (retention for all; maxTables/maxColumns for Cloud Dedicated/Clustered)	All versions
`delete_database`	Delete a database by name (irreversible)	All versions
`execute_query`	Run a SQL query against a database (supports multiple formats)	All versions
`get_measurements`	List all measurements (tables) in a database	All versions
`get_measurement_schema`	Get schema (columns/types) for a measurement/table	All versions
`create_admin_token`	Create a new admin token (full permissions)	Core/Enterprise only
`list_admin_tokens`	List all admin tokens (with optional filtering)	Core/Enterprise only
`create_resource_token`	Create a resource token for specific DBs and permissions	Core/Enterprise only
`list_resource_tokens`	List all resource tokens (with filtering and ordering)	Core/Enterprise only
`delete_token`	Delete a token by name	Core/Enterprise only
`regenerate_operator_token`	Regenerate the operator token (dangerous/irreversible)	Core/Enterprise only
`cloud_list_database_tokens`	List all database tokens for Cloud-Dedicated/Clustered cluster	Cloud Dedicated/Clustered
`cloud_get_database_token`	Get details of a specific database token by ID	Cloud Dedicated/Clustered
`cloud_create_database_token`	Create a new database token for Cloud-Dedicated/Clustered cluster	Cloud Dedicated/Clustered
`cloud_update_database_token`	Update an existing database token	Cloud Dedicated/Clustered
`cloud_delete_database_token`	Delete a database token from Cloud-Dedicated/Clustered cluster	Cloud Dedicated/Clustered
`list_databases`	List all available databases in the instance	All versions
`health_check`	Check InfluxDB connection and health status	All versions

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

cloud_create_database_token

Создает новый токен базы данных для кластера InfluxDB Cloud-Dedicated/Clustered. Указывает точные разрешения для каждой базы данных или создает токен без доступа. Формат разрешений: [{"database": "db_name", "action": "read|write"}, ...] Примеры: • Без доступа: опускает поле permissions или использует [] • Только чтение на 'analytics': [{"database": "analytics", "action": "read"}] • Смешанные разрешения: [{"database": "logs", "action": "read"}, {"database": "metrics", "action": "write"}] • Полный доступ: [{"database": "", "action": "read"}, {"database": "", "action": "write"}]

Параметры

descriptionstringобязательный
Description/name for the token
permissionsobject[]
Array of permission objects. Each object specifies database and action. Leave empty array [] for no-access token.

cloud_delete_database_token

Удаляет токен базы данных из кластера InfluxDB Cloud-Dedicated/Clustered. Это действие нельзя отменить.

Параметры

token_idstringобязательный
The ID of the token to delete

cloud_get_database_token

Получает сведения о конкретном токене базы данных по идентификатору для кластера InfluxDB Cloud-Dedicated/Clustered.

Параметры

token_idstringобязательный
The ID of the token to retrieve

cloud_list_database_tokens

Перечисляет все токены базы данных для кластера InfluxDB Cloud-Dedicated/Clustered. Возвращает информацию о токенах, включая разрешения и даты создания.

Параметры

Без параметров.

cloud_update_database_token

Обновляет существующий токен базы данных для кластера InfluxDB Cloud-Dedicated/Clustered. Обновляет описание и/или права доступа с точным контролем. Формат прав доступа: [{"database": "db_name", "action": "read|write"}, ...] Примечание: права доступа полностью заменяют существующие - включите все необходимые права. Примеры: • Нет доступа: используйте [] • Только чтение в 'analytics': [{"database": "analytics", "action": "read"}] • Смешанные права: [{"database": "logs", "action": "read"}, {"database": "metrics", "action": "write"}] • Полный доступ: [{"database": "", "action": "read"}, {"database": "", "action": "write"}]

Параметры

descriptionstring
New description for the token (optional)
permissionsobject[]
Array of permission objects. Each object specifies database and action. Use empty array [] for no-access token.
token_idstringобязательный
The ID of the token to update

create_admin_token

Создаёт новый именованный административный токен InfluxDB с полными административными правами (только Core/Enterprise). Именованные административные токены могут управлять базами данных, пользователями и токенами ресурсов, но не могут управлять другими административными токенами.

Параметры

namestring
Optional name for the admin token (e.g., "backup-admin-token"). If not provided, a unique name will be generated.

create_database

Создаёт новую базу данных в InfluxDB. Имена баз данных должны соответствовать правилам именования InfluxDB: допускаются буквенно-цифровые символы, дефисы (-), подчёркивания (_) и косые черты (/). Имя должно начинаться с буквы или цифры. Максимальная длина — 64 символа. Для Cloud Dedicated/Clustered: maxTables, maxColumnsPerTable, retentionPeriod. Для Cloud Serverless: description, retentionPeriod.

Параметры

descriptionstring
Description for the bucket/database (Cloud Serverless only)
maxColumnsPerTablenumber
Maximum columns per table (Cloud Dedicated/Clustered only, default: 200)
maxTablesnumber
Maximum number of tables (Cloud Dedicated/Clustered only, default: 500)
namestringобязательный
Name of the database to create (alphanumeric, -, _, / allowed; max 64 chars; must start with letter/number)
retentionPeriodnumber
Retention period in nanoseconds (Cloud Dedicated/Clustered: default 0 = no expiration, Cloud Serverless: default 30 days)

create_resource_token

Создаёт новый токен ресурса InfluxDB с определёнными разрешениями для баз данных (только Core/Enterprise). Пример: databases=["mydb", "testdb"], actions=["read", "write"]

Параметры

actionsenum[]обязательный
Array of permissions for the databases. Example: ["read"] for read-only, ["read", "write"] for full access, or ["write"] for write-only.
databasesstring[]обязательный
Array of database names this token can access. Example: ["database1", "database2"]. Use exact database names from your InfluxDB instance.
descriptionstringобязательный
Description/name for the resource token (e.g., "My App Token")
expiry_secsnumber
Optional expiration time in seconds (e.g., 3600 for 1 hour, 86400 for 1 day, 604800 for 1 week). If not specified, token never expires.

delete_database

Удаляет базу данных из InfluxDB. Используйте точное имя базы данных, возвращённое инструментом list_databases.

Параметры

namestringобязательный
Name of the database to delete (use exact name from database list)

delete_token

Удаляет токен InfluxDB по имени (только Core/Enterprise).

Параметры

token_namestringобязательный
Name of the token to delete (required)

describe_table

Описывает схему таблицы с помощью метаданных InfluxDB. Неизвестные роли тегов/полей возвращаются как category=unknown, а не угаданные. Используйте это перед повторной попыткой SQL-запросов, которые завершаются ошибкой из-за заключенного в кавычки шаблона или селектора неизвестного поля; явно раскройте соответствующие поля и выполните один ограниченный query_sql.

Параметры

dbstringобязательный
Database name containing the table
tablestringобязательный
Table or measurement name to describe

execute_query

Выполняет SQL-запрос к базе данных InfluxDB (все версии). Возвращает результаты в указанном формате (по умолчанию JSON). Предупреждение о больших наборах данных: InfluxDB может содержать огромные массивы временных рядов. Всегда сначала используйте COUNT() для проверки размера, затем применяйте LIMIT/OFFSET для больших результатов (более 1000 строк). Требования для Cloud Dedicated/Clustered и Cloud Serverless (v3): - GROUP BY: Включайте все группируемые столбцы в SELECT (например, SELECT place, COUNT() ... GROUP BY place) - Агрегации: Приводите тип и задавайте псевдоним для COUNT (например, CAST(COUNT(*) AS DOUBLE) AS count) - Примечание: Оба продукта требуют CAST для всех агрегатных функций (COUNT, SUM, AVG, MIN, MAX), чтобы результаты правильно отображались в ответе.

Параметры

databasestringобязательный
Name of the database/bucket to query
formatenum
Output format for query results
querystringобязательный
SQL query to execute.

get_help

Получает справочную информацию и рекомендации по устранению неполадок для операций с InfluxDB. Поддерживает поиск по конкретным категориям или ключевым словам.

Параметры

Без параметров.

get_measurements

Получает список всех измерений (таблиц) в базе данных/бакете (все версии). Использует InfluxDB information_schema.columns для обнаружения таблиц.

Параметры

databasestringобязательный
Name of the database/bucket to list measurements from

get_measurement_schema

Получает схему (информацию о столбцах) для конкретного measurement/table (все версии). Показывает имена столбцов, типы и категории (time/tag/field).

Параметры

databasestringобязательный
Name of the database/bucket containing the measurement
measurementstringобязательный
Name of the measurement to describe

health_check

Проверяет текущее состояние подключения к экземпляру InfluxDB. Возвращает статус подключения, конфигурацию и результаты доступных конечных точек. Оценка работоспособности гибкая - если любая проверка проходит (инициализация клиента, конечная точка /health или /ping), экземпляр считается работоспособным. Доступные проверки зависят от типа продукта InfluxDB и конфигурации токена.

Параметры

Без параметров.

investigate_database

Обнаруживает таблицы и схемы в базе данных, опционально выбирая образцы последних строк из каждой таблицы с ограничением на количество прочитанных записей.

Параметры

dbstringобязательный
Database name to investigate
includeSamplesboolean
Whether to include recent sample rows
maxTablesnumber
sampleRowsPerTablenumber

list_admin_tokens

Перечисляет все административные токены (операторские и именованные административные токены) с возможностью фильтрации по имени токена (только Core/Enterprise). Именованные административные токены имеют полный административный доступ, включая управление токенами ресурсов.

Параметры

tokenNamestring
Optional filter to search for tokens with names containing this text (case-insensitive partial match)

list_databases

Перечисляет все базы данных в экземпляре InfluxDB (все версии). Возвращает названия баз данных, их количество и информацию о статусе.

Параметры

Без параметров.

list_resource_tokens

Выводит список всех токенов ресурсов с возможностью фильтрации по имени базы данных и/или имени токена и сортировкой (только Core/Enterprise).

Параметры

databaseNamestring
Optional filter to show only tokens that have access to this database (partial match)
orderByenum
Optional field to order results by
orderDirectionenum
Optional direction for ordering (ASC or DESC). Defaults to ASC.
tokenNamestring
Optional filter to search for tokens with names containing this text (case-insensitive partial match)

list_tables

Перечисляет таблицы, также называемые измерениями, в базе данных InfluxDB.

Параметры

dbstringобязательный
Database name to inspect

load_database_context

Проверяет и загружает пользовательский контекст базы данных, если он доступен. Всегда проверяйте это в первую очередь — это может значительно ускорить анализ и прояснить нюансы данных. Контекст от пользователя optional, но если он есть, то содержит полезную информацию о структуре базы данных, бизнес-контексте или личных заметках, которые помогут сделать анализ точнее.

Параметры

Без параметров.

query_influxql

Выполняет один ограниченный запрос InfluxQL только для чтения к базе данных InfluxDB 3. Отклоняет операторы SELECT INTO и деструктивные инструкции. Отдавайте предпочтение query_sql для запросов на SQL; используйте выбор полей по регулярному выражению InfluxQL только тогда, когда пользователь явно запрашивает InfluxQL или сопоставление по регулярному выражению.

Параметры

dbstringобязательный
Database name to query
formatenum
Output format for query results
maxRowsnumber
Maximum rows to return. Default 1000; hard max 5000.
paramsany
Optional query parameters to pass through
qstringобязательный
Read-only InfluxQL query to run
timeoutMsnumber
Optional query timeout in milliseconds

query_sql

Выполняет один ограниченный SQL-запрос только для чтения к базе данных InfluxDB 3. По умолчанию выводит JSON и возвращает структурированные строки, предупреждения и метаданные запроса. В SQL идентификаторы в кавычках обозначают точные имена столбцов; если селектор в кавычках содержит *, считайте это намерением использовать подстановочный знак, вызовите describe_table, явно разверните соответствующие поля, затем повторите один ограниченный query_sql. Используйте regex query_influxql только когда пользователь явно запрашивает InfluxQL или выбор полей через regex.

Параметры

dbstringобязательный
Database name to query
formatenum
Output format for query results
maxRowsnumber
Maximum rows to return. Default 1000; hard max 5000.
paramsany
Optional query parameters to pass through
qstringобязательный
Read-only SQL query to run
timeoutMsnumber
Optional query timeout in milliseconds

regenerate_operator_token

Регенерирует токен оператора InfluxDB (только Core/Enterprise). Возвращает новое значение токена. ⚠️ Это действие делает текущий токен оператора недействительным и является необратимым. Получите явное подтверждение пользователя перед выполнением.

Параметры

Без параметров.

update_database

Обновляет конфигурацию базы данных для InfluxDB. Для Cloud Dedicated/Clustered: измените maxTables, maxColumnsPerTable и retentionPeriod. Для Cloud Serverless: измените имя bucket, описание и retentionPeriod. Для Core/Enterprise: измените только retentionPeriod (для Core требуется v3.2.0+).

Параметры

descriptionstring
Description for the bucket (Cloud Serverless only)
maxColumnsPerTablenumber
Maximum columns per table (Cloud Dedicated/Clustered only)
maxTablesnumber
Maximum number of tables (Cloud Dedicated/Clustered only)
namestringобязательный
Name of the database/bucket to update
newNamestring
New name for the database/bucket (Cloud Serverless only)
retentionPeriodnumber
Retention period in nanoseconds (Cloud Dedicated/Clustered, Cloud Serverless, and Core/Enterprise)

write_line_protocol

Записывает данные в InfluxDB с помощью формата line protocol (все версии). Поддерживает одиночные записи или пакеты. Синтаксис Line Protocol: measurement,tag1=value1,tag2=value2 field1=value1,field2=value2 timestamp Компоненты: - measurement: название таблицы/измерения (обязательно) - tags: индексированные метаданные (опционально) — пары ключ=значение, разделённые запятыми - fields: фактические данные (обязательно) — отделяются от тегов пробелом, пары ключ=значение, разделённые запятыми - timestamp: опциональная временная метка (точность должна быть указана в параметрах инструмента) Типы значений полей: - Строки: "строка в кавычках" - Числа с плавающей точкой: 123.45 - Целые числа: 123i (обратите внимание на суффикс 'i') - Логические значения: t или f Примеры: Одиночная запись: temperature,location=office,building=main value=23.5,humidity=45i 1640995200 Пакет (разделяются переводами строк): temperature,location=office value=23.5 1640995200 humidity,location=office value=45i 1640995201 Важно: Всегда указывайте правильный параметр точности, чтобы он соответствовал формату временной метки. Используйте любую точность при записи данных без временной метки. Для специальных символов в тегах/полях требуется экранирование.

Параметры

acceptPartialboolean
Accept partial writes
datastringобязательный
Line protocol formatted data. For multiple records, separate each line with \n
databasestringобязательный
Name of the database/bucket to write to
noSyncboolean
Acknowledge without waiting for WAL persistence
precisionenumобязательный
Precision of timestamps

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

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

{
  "command": "npx",
  "args": [
    "-y",
    "@influxdata/influxdb3-mcp-server"
  ],
  "env": {
    "INFLUX_DB_INSTANCE_URL": "http://localhost:8181/",
    "INFLUX_DB_TOKEN": "<YOUR_INFLUXDB_TOKEN>",
    "INFLUX_DB_PRODUCT_TYPE": "core"
  }
}

Нужен npx

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

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

FAQ

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

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

Что он умеет?

Сервер управляет базами данных InfluxDB: создаёт, обновляет конфигурацию, удаляет и перечисляет их. Пишет данные в формате line protocol, выполняет SQL и InfluxQL запросы только на чтение, получает список измерений и схемы таблиц, исследует базы и сэмплирует данные для анализа. Работает с токенами доступа: для локальных версий создаёт админские и ресурсные токены, перечисляет, удаляет и регенерирует операторский токен, для облака создаёт, обновляет, удаляет и просматривает токены баз данных. Проверяет подключение к серверу, загружает пользовательский контекст и отвечает на вопросы по настройке.