Сервер InfluxDB MCP

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

Функции

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

• Ресурсы : доступ к данным организации, сегмента и измерений.

• Инструменты : запись данных, выполнение запросов и управление объектами базы данных.

• Подсказки : Шаблоны для общих запросов Flux и формат линейного протокола

Related MCP server: InfluxDB OSS API MCP Server

Ресурсы

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

1. Список организаций : influxdb://orgs

   • Отображает все организации в экземпляре InfluxDB

2. Список Buckets : influxdb://buckets

   • Показывает все сегменты с их метаданными.

3. Измерения ведра : influxdb://bucket/{bucketName}/measurements

   • Перечисляет все измерения в указанном сегменте

4. Запрос данных : influxdb://query/{orgName}/{fluxQuery}

   • Выполняет запрос Flux и возвращает результаты в виде ресурса

Инструменты

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

1. write-data : Запись данных временного ряда в формате линейного протокола

   • Параметры: org, bucket, data, precision (необязательно)

2. query-data : Выполнение запросов Flux

   • Параметры: org, запрос

3. create-bucket : Создать новый контейнер

   • Параметры: имя, orgID, remainnerPeriodSeconds (необязательно)

4. create-org : Создать новую организацию

   • Параметры: имя, описание (необязательно)

Подсказки

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

1. flux-query-examples : Примеры общих запросов Flux

2. line-protocol-guide : Руководство по формату линейного протокола InfluxDB

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

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

• INFLUXDB_TOKEN (обязательно): токен аутентификации для API InfluxDB

• INFLUXDB_URL (необязательно): URL-адрес экземпляра InfluxDB (по умолчанию http://localhost:8086 )

• INFLUXDB_ORG (необязательно): название организации по умолчанию для определенных операций.

Установка

Установка через Smithery

Чтобы автоматически установить InfluxDB MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claude

Вариант 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

Лицензия

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