Servidor MCP de InfluxDB

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone el acceso a una instancia de InfluxDB mediante la API OSS de InfluxDB v2. Desarrollado principalmente con Claude Code.

Características

Este servidor MCP proporciona:

Recursos : Acceso a datos de organización, grupo y medición
Herramientas : escribir datos, ejecutar consultas y administrar objetos de base de datos
Indicaciones : Plantillas para consultas Flux comunes y formato de protocolo de línea

Recursos

El servidor expone los siguientes recursos:

Lista de organizaciones : influxdb://orgs
- Muestra todas las organizaciones en la instancia de InfluxDB
Lista de deseos : influxdb://buckets
- Muestra todos los depósitos con sus metadatos
Medidas del cubo : influxdb://bucket/{bucketName}/measurements
- Enumera todas las mediciones dentro de un grupo específico
Datos de consulta : influxdb://query/{orgName}/{fluxQuery}
- Ejecuta una consulta Flux y devuelve resultados como un recurso

Herramientas

El servidor proporciona estas herramientas:

write-data : escribe datos de series temporales en formato de protocolo de línea
- Parámetros: organización, contenedor, datos, precisión (opcional)
query-data : Ejecutar consultas Flux
- Parámetros: org, consulta
create-bucket : Crea un nuevo bucket
- Parámetros: nombre, orgID, retainPeriodSeconds (opcional)
create-org : Crea una nueva organización
- Parámetros: nombre, descripción (opcional)

Indicaciones

El servidor ofrece estas plantillas de indicaciones:

flux-query-examples : Ejemplos comunes de consultas Flux
line-protocol-guide : Guía del formato del protocolo de línea de InfluxDB

Configuración

El servidor requiere estas variables de entorno:

INFLUXDB_TOKEN (obligatorio): Token de autenticación para la API de InfluxDB
INFLUXDB_URL (opcional): URL de la instancia de InfluxDB (el valor predeterminado es http://localhost:8086 )
INFLUXDB_ORG (opcional): Nombre de la organización predeterminado para ciertas operaciones

Instalación

Opción 1: Ejecutar con npx (recomendado)

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

Opción 2: Instalar globalmente

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

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

Opción 3: Desde la fuente

# 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

Integración con Claude para escritorio

Agregue el servidor a su claude_desktop_config.json :

Usando npx (recomendado)

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

Si se instala localmente

{
  "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"
      }
    }
  }
}

Estructura del código

El código del servidor está organizado en una estructura modular:

src/
- index.js - Punto de entrada del servidor principal
- config/ - Archivos relacionados con la configuración
  - env.js - Manejo de variables de entorno
- utils/ - Funciones de utilidad
  - influxClient.js - Cliente de la API de InfluxDB
  - loggerConfig.js - Configuración del registrador de la consola
- handlers/ - Manipuladores de recursos y herramientas
  - organizationsHandler.js - Listado de organizaciones
  - bucketsHandler.js - Listado de buckets
  - measurementsHandler.js - Listado de mediciones
  - queryHandler.js - Ejecución de consultas
  - writeDataTool.js - Herramienta de escritura de datos
  - queryDataTool.js - Herramienta de consulta
  - createBucketTool.js - Herramienta de creación de buckets
  - createOrgTool.js - Herramienta de creación de organizaciones
- prompts/ - Plantillas de indicaciones
  - fluxQueryExamplesPrompt.js - Ejemplos de consultas Flux
  - lineProtocolGuidePrompt.js - Guía del protocolo de línea

Esta estructura permite un mejor mantenimiento, pruebas más sencillas y una separación más clara de las preocupaciones.

Pruebas

El repositorio incluye pruebas de integración integrales que:

Ponga en marcha un contenedor Docker con InfluxDB
Rellénelo con datos de muestra
Pruebe todas las funciones del servidor MCP

Para ejecutar las pruebas:

npm test

Licencia

Instituto Tecnológico de Massachusetts (MIT)

InfluxDB MCP Server

Integrations