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

Related MCP server: InfluxDB OSS API MCP Server

Recursos

El servidor expone los siguientes recursos:

1. Lista de organizaciones : influxdb://orgs

   • Muestra todas las organizaciones en la instancia de InfluxDB

2. Lista de deseos : influxdb://buckets

   • Muestra todos los depósitos con sus metadatos

3. Medidas del cubo : influxdb://bucket/{bucketName}/measurements

   • Enumera todas las mediciones dentro de un grupo específico

4. Datos de consulta : influxdb://query/{orgName}/{fluxQuery}

   • Ejecuta una consulta Flux y devuelve resultados como un recurso

Herramientas

El servidor proporciona estas herramientas:

1. write-data : escribe datos de series temporales en formato de protocolo de línea

   • Parámetros: organización, contenedor, datos, precisión (opcional)

2. query-data : Ejecutar consultas Flux

   • Parámetros: org, consulta

3. create-bucket : Crea un nuevo bucket

   • Parámetros: nombre, orgID, retainPeriodSeconds (opcional)

4. create-org : Crea una nueva organización

   • Parámetros: nombre, descripción (opcional)

Indicaciones

El servidor ofrece estas plantillas de indicaciones:

1. flux-query-examples : Ejemplos comunes de consultas Flux

2. 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

Instalación mediante herrería

Para instalar InfluxDB MCP Server para Claude Desktop automáticamente a través de Smithery :

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

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)