InfluxDB 3 — MCP-сервер для Claude Code: запросы и запись в базы
Официальный MCP-сервер InfluxDB 3: агент читает и пишет данные, смотрит схему и разбирает ошибки запросов. Пригодится, когда нужно копаться в базе прямо из чата.
claude mcp add --env INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> --env INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> --env INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> --env INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> --env INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> --transport stdio influxdb-3 -- npx -y @influxdata/influxdb3-mcp-serverЧто делает InfluxDB 3
Сервер даёт агенту инструменты для работы с InfluxDB 3 Core, Enterprise, Cloud Dedicated, Clustered и Cloud Serverless. Через него можно выполнять SQL и InfluxQL, писать данные, управлять базами и токенами. Список инструментов зависит от профиля: при INFLUX_MCP_TOOL_PROFILE=readonly остаются только чтение и разведка, а всё, что пишет или администрирует, отключается.
Токен передаётся в заголовке Bearer, и сервер его не проверяет — права решает сам токен. Поэтому урезанный токен просто не увидит лишние базы. Ошибки приходят структурно: у них есть error.code, error.recovery и error.retryable. Скажем, 403 означает not_found_or_denied, а запрос к несуществующей таблице советует поправить ссылку через list_tables или describe_table.
Для запуска нужен Node.js v20.11 или новее, а также URL и токен инстанса InfluxDB 3. В Docker-сборке понадобится Docker. Локальная разработка идёт через pnpm — версия закреплена в package.json, включить её можно командой corepack enable.
Какие задачи решает
- выполнить SQL или InfluxQL по базе прямо из агента
- посмотреть список баз, таблиц и колонок перед запросом
- разобрать, почему панель перестала показывать данные после деплоя
- отличить отсутствующие данные от сломанного запроса
- дать агенту доступ только на чтение, без записи и администрирования
Примеры запросов агенту
- Покажи список баз и таблиц в InfluxDB, потом посчитай среднюю температуру по датчикам за сутки
- Почему этот запрос InfluxQL возвращает пустой результат? Проверь измерение и колонки
- Собери ограниченный SQL-запрос по таблице
sensorsи верни строки с предупреждениями
Как установить InfluxDB 3
Командой платформы
claude mcp add --env INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> --env INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> --env INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> --env INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> --env INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> --transport stdio influxdb-3 -- npx -y @influxdata/influxdb3-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add influxdb-3 --env INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> --env INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> --env INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> --env INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> --env INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> -- npx -y @influxdata/influxdb3-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"influxdb-3": {
"command": "npx",
"args": [
"-y",
"@influxdata/influxdb3-mcp-server"
],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "<INFLUX_DB_PRODUCT_TYPE>",
"INFLUX_DB_TOKEN": "<INFLUX_DB_TOKEN>",
"INFLUX_DB_INSTANCE_URL": "<INFLUX_DB_INSTANCE_URL>",
"INFLUX_DB_MANAGEMENT_TOKEN": "<INFLUX_DB_MANAGEMENT_TOKEN>",
"INFLUX_DB_ACCOUNT_ID": "<INFLUX_DB_ACCOUNT_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"influxdb-3": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@influxdata/influxdb3-mcp-server"
],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "<INFLUX_DB_PRODUCT_TYPE>",
"INFLUX_DB_TOKEN": "<INFLUX_DB_TOKEN>",
"INFLUX_DB_INSTANCE_URL": "<INFLUX_DB_INSTANCE_URL>",
"INFLUX_DB_MANAGEMENT_TOKEN": "<INFLUX_DB_MANAGEMENT_TOKEN>",
"INFLUX_DB_ACCOUNT_ID": "<INFLUX_DB_ACCOUNT_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> -e INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> -e INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> -e INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> -e INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> influxdb-3 npx -y @influxdata/influxdb3-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о InfluxDB 3
Как установить InfluxDB 3 в Claude Code?
Добавьте сервер командой `claude mcp add influxdb3-mcp-server -e INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> -e INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> -e INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> -- npx -y @influxdata/influxdb3-mcp-server`. Подставьте свои значения вместо плейсхолдеров.
Что делает InfluxDB 3 MCP-сервер?
Даёт агенту инструменты для чтения и записи в InfluxDB 3, разведки схемы и разбора ошибок запросов. В режиме только для чтения инструменты записи и администрирования отключаются.
Что нужно для работы сервера?
Инстанс InfluxDB 3 с URL и токеном, а также Node.js v20.11 или новее. Для Docker-сборки нужен Docker.
