Сервер InfluxDB MCP

Сервер Model Context Protocol (MCP), который предоставляет доступ к экземпляру InfluxDB с помощью InfluxDB OSS API v2. В основном создан с помощью Claude Code.

Функции

Этот сервер MCP обеспечивает:

Ресурсы : доступ к данным организации, сегмента и измерений.
Инструменты : запись данных, выполнение запросов и управление объектами базы данных.
Подсказки : Шаблоны для общих запросов Flux и формат линейного протокола

Ресурсы

Сервер предоставляет следующие ресурсы:

Список организаций : influxdb://orgs
- Отображает все организации в экземпляре InfluxDB
Список Buckets : influxdb://buckets
- Показывает все сегменты с их метаданными.
Измерения ведра : influxdb://bucket/{bucketName}/measurements
- Перечисляет все измерения в указанном сегменте
Запрос данных : influxdb://query/{orgName}/{fluxQuery}
- Выполняет запрос Flux и возвращает результаты в виде ресурса

Инструменты

Сервер предоставляет следующие инструменты:

write-data : Запись данных временного ряда в формате линейного протокола
- Параметры: org, bucket, data, precision (необязательно)
query-data : Выполнение запросов Flux
- Параметры: org, запрос
create-bucket : Создать новый контейнер
- Параметры: имя, orgID, remainnerPeriodSeconds (необязательно)
create-org : Создать новую организацию
- Параметры: имя, описание (необязательно)

Подсказки

Сервер предлагает следующие шаблоны подсказок:

flux-query-examples : Примеры общих запросов Flux
line-protocol-guide : Руководство по формату линейного протокола InfluxDB

Конфигурация

Серверу требуются следующие переменные среды:

INFLUXDB_TOKEN (обязательно): токен аутентификации для API InfluxDB
INFLUXDB_URL (необязательно): URL-адрес экземпляра InfluxDB (по умолчанию http://localhost:8086 )
INFLUXDB_ORG (необязательно): название организации по умолчанию для определенных операций.

Установка

Вариант 1: Запуск с npx (рекомендуется)

# Run directly with npx
INFLUXDB_TOKEN=your_token npx influxdb-mcp-server

Вариант 2: Глобальная установка

# Install globally
npm install -g influxdb-mcp-server

# Run the server
INFLUXDB_TOKEN=your_token influxdb-mcp-server

Вариант 3: Из источника

# Clone the repository
git clone https://github.com/idoru/influxdb-mcp-server.git
cd influxdb-mcp-server

# Install dependencies
npm install

# Run the server
INFLUXDB_TOKEN=your_token npm start

Интеграция с Claude для рабочего стола

Добавьте сервер в ваш claude_desktop_config.json :

Использование npx (рекомендуется)

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

Если установлено локально

{
  "mcpServers": {
    "influxdb": {
      "command": "node",
      "args": ["/path/to/influxdb-mcp-server/src/index.js"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Структура кода

Код сервера организован в виде модульной структуры:

src/
- index.js — Основная точка входа сервера
- config/ - Файлы, связанные с конфигурацией
  - env.js — Обработка переменных среды
- utils/ - Вспомогательные функции
  - influxClient.js — клиент API InfluxDB
  - loggerConfig.js — Конфигурация консольного логгера
- handlers/ - Обработчики ресурсов и инструментов
  - organizationsHandler.js — список организаций
  - bucketsHandler.js — список контейнеров
  - measurementsHandler.js — список измерений
  - queryHandler.js — выполнение запроса
  - writeDataTool.js — инструмент записи данных
  - queryDataTool.js — инструмент запросов
  - createBucketTool.js — инструмент создания контейнера
  - createOrgTool.js — инструмент создания организации
- prompts/ - Шаблоны подсказок
  - fluxQueryExamplesPrompt.js — примеры запросов Flux
  - lineProtocolGuidePrompt.js — Руководство по протоколу линии

Такая структура обеспечивает лучшую ремонтопригодность, более простое тестирование и более четкое разделение задач.

Тестирование

Репозиторий включает в себя комплексные интеграционные тесты, которые:

Разверните контейнер Docker с помощью InfluxDB
Заполните его образцами данных.
Тестирование всех функций сервера MCP.

Для запуска тестов:

npm test

Лицензия

Массачусетский технологический институт

InfluxDB MCP Server

Integrations