InfluxDB 3 MCP Server
Официальный MCP-сервер InfluxData: агент читает схему временных рядов InfluxDB 3 и гоняет SQL и InfluxQL с лимитами на выдачу
- 38 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Токен администратора открывает удаление баз и выпуск токенов, а перевыпуск операторского токена необратим
- Агент отправляет SQL и InfluxQL с правами токена, а границу доступа задает сам токен
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/influxdb-3-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен администратора открывает удаление баз и выпуск токенов, а перевыпуск операторского токена необратим
- Агент отправляет SQL и InfluxQL с правами токена, а границу доступа задает сам токен
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер InfluxData подключает агента к InfluxDB 3: Core, Enterprise, Cloud Dedicated, Clustered и Cloud Serverless. Агент перечисляет базы и таблицы, смотрит схему, выполняет запросы на SQL и InfluxQL и проверяет здоровье инстанса. Чтение устроено с оглядкой на ошибки модели. Инструменты query_sql и query_influxql ограничивают выдачу, а в ответе есть признак полноты, число строк и предупреждения. Инструмент investigate_database выбирает по таблицам образцы за окно времени, по умолчанию за 24 часа, и не падает целиком, если одна таблица недоступна. Ошибки приходят с кодом, подсказкой следующего шага и флагом, стоит ли повторять вызов. На запись и администрирование тоже есть инструменты: write_line_protocol, создание и удаление баз, выпуск и удаление токенов. Профиль INFLUX_MCP_TOOL_PROFILE=readonly убирает их все, и агенту остаются только исследование и запросы.
Для кого. Аналитикам и инженерам, у кого метрики, телеметрия или данные датчиков лежат в InfluxDB 3 и кто хочет задавать вопросы к ним словами из Claude Desktop, Cursor или Codex.
Подходит, если
- Дашборд перестал показывать данные после релиза, и надо понять, переименована ли схема или сломан запрос InfluxQL
- В незнакомой базе непонятно, какие таблицы и колонки есть, и агент должен собрать картину по образцам данных
- Нужен ответ вроде «какие датчики дали самую высокую среднюю температуру за сутки» без ручного написания SQL
- Подготовка пачки данных: агент пишет строки в формате line protocol в тестовую базу
- Проверка соединения и состояния инстанса перед запуском скриптов
Не подходит, если
- Нужны оценки кардинальности: сервер такие оценки пока не считает
- Агенту нельзя доверять токен с правом записи: тогда включайте профиль readonly и токен с доступом только на чтение
- База работает на InfluxDB 1.x или 2.x: сервер написан под третью версию
- Нужен постоянный мониторинг с алертами: сервер отвечает на запросы агента и сам ничего не отслеживает
Пример запроса к агенту
Какие базы есть в этом инстансе, и у каких датчиков средняя температура за последние 24 часа выше всех?MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
INFLUX_DB_INSTANCE_URLобязательная- Адрес инстанса InfluxDB 3
INFLUX_DB_TOKENобязательная, секрет- Токен администратора, ограниченный токен или JWT
INFLUX_DB_PRODUCT_TYPEобязательная- Тип продукта: core, enterprise, cloud-serverless, cloud-dedicated или clustered
INFLUX_MCP_TOOL_PROFILE- Значение readonly оставляет только чтение
Ограничения
Нужен рабочий инстанс InfluxDB 3, его адрес и токен. Для Cloud Dedicated и Clustered добавляются идентификатор кластера и токены управления. Для запуска через npx нужна свежая Node.js: README перечисляет минимальные версии веток 22, 24 и 26 и предупреждает, что Node.js 20 больше не поддерживается.
Среди инструментов есть необратимые: удаление базы, удаление токена, перевыпуск операторского токена. Ограничения инструментов подсказывают модели, где остановиться, а границу доступа задают права самого токена. Версия 2.0 изменила формат ответов запросов и проверки здоровья, поэтому клиенты со старым разбором ответов надо обновить.
Как отключить. Удалите блок influxdb из конфигурации MCP-клиента и перезапустите клиента. Токены, которые агент успел выпустить, отзовите в самом InfluxDB.
Частые вопросы
Как подключить InfluxDB 3 к Claude Desktop или Cursor?
Добавьте в конфигурацию клиента блок с командой npx и аргументами -y @influxdata/influxdb3-mcp-server, а в env задайте INFLUX_DB_INSTANCE_URL, INFLUX_DB_TOKEN и INFLUX_DB_PRODUCT_TYPE (core, enterprise, cloud-serverless, cloud-dedicated или clustered). После перезапуска клиента вызовите health_check.
Как запретить агенту писать в базу?
Задайте INFLUX_MCP_TOOL_PROFILE=readonly: профиль не загружает инструменты записи, администрирования баз, управления токенами и запуска на хосте. Права токена остаются главной защитой, поэтому берите токен только на чтение.
Какие версии InfluxDB поддерживает сервер?
InfluxDB 3 Core и Enterprise, а также Cloud Dedicated, Clustered и Cloud Serverless. Тип выбирается переменной INFLUX_DB_PRODUCT_TYPE, часть инструментов доступна только на отдельных продуктах: например, токены ресурсов только в Enterprise.
Что увидит агент, если запрос не удался?
Структурированную ошибку с полями code, recovery и retryable. Ответ 403 приходит как not_found_or_denied независимо от того, есть ли база, а запрос к неизвестной таблице получает подсказку вызвать list_tables или describe_table.
Запускает ли сервер что-то на моей машине?
Сервер сам работает на вашем компьютере через stdio и ходит только на адрес вашего инстанса InfluxDB. Профиль readonly дополнительно убирает инструменты, которые выполняются на хосте.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыАгент запрашивает метрики, логи и трассы из GreptimeDB на SQL, TQL и RANGE, с запретом записи и маскировкой чувствительных данных
MCP-сервер для доступа агента к MySQL: чтение схемы и запросы, по умолчанию только на чтение, запись включается флагами
MCP-сервер InfraNodus строит из текста граф знаний и показывает кластеры тем, пробелы между ними и вопросы для исследования
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
MySQL MCP Server Pro
mysql_mcp_server_pro
MCP-сервер для MySQL: выполняет SQL с ролями доступа, ищет таблицы по комментариям и разбирает блокировки, индексы и планы запросов
Официальный MCP-сервер Apache IoTDB: SQL-запросы к временным рядам в древовидной и табличной модели, экспорт в CSV и Excel
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| InfluxDB 3 MCP Server (эта карточка) | да | API-ключ | 38 | |
| Prometheus MCP Server | нет | не нужна | 525 | запросы к метрикам Prometheus на PromQL |
| ClickHouse MCP Server | нет | API-ключ | 904 | аналитическая колоночная база ClickHouse |
| Grafana MCP Server | да | API-ключ | 3 663 | дашборды и источники данных Grafana |
Коротко о README
В README описаны требования, чтение без записи, примеры сценариев и таблица из 27 инструментов с пометкой, на каких продуктах они доступны. Отдельно перечислены четыре ресурса и три промпта, а также настройка для каждого типа инстанса. Запуск возможен через npx, из исходников и в Docker.