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

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)

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor de protocolo de contexto de modelo que proporciona a Claude acceso a instancias de la base de datos de series de tiempo InfluxDB, lo que permite la escritura de datos, la consulta y la gestión de organizaciones y grupos a través del lenguaje natural.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Database MCP Server
georgi-terziyski
-
security
-
license
-
quality
A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
Last updated -
Python
MCP Database Server
dwarvesf
-
security
F
license
-
quality
A Model Context Protocol server that provides tools for interacting with databases, including PostgreSQL, DuckDB, and Google Cloud Storage Parquet files.
Last updated -
2
TypeScript
InfluxDB MCP Server
m4tyn0
-
security
F
license
-
quality
A Model Context Protocol server that provides secure, read-only access to time-series data stored in InfluxDB 1.8 via JWT authentication.
Last updated -
Python
MCP Database Server
manpreet2000
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
Last updated -
TypeScript
MIT License

View all related MCP servers

InfluxDB MCP Server