InfluxDB v2 MCP Server

A Model Context Protocol (MCP) server that exposes access to an InfluxDB v2 instance using the InfluxDB OSS API v2. Mostly built with Claude Code.

Features

This MCP server provides:

• Resources: Access to organization, bucket, and measurement data
• Tools: Write data, execute queries, and manage database objects
• Prompts: Templates for common Flux queries and Line Protocol format

Resources

The server exposes the following resources:

1. Organizations List: influxdb://orgs

   • Displays all organizations in the InfluxDB instance

2. Buckets List: influxdb://buckets

   • Shows all buckets with their metadata

3. Bucket Measurements: influxdb://bucket/{bucketName}/measurements

   • Lists all measurements within a specified bucket (uses INFLUXDB_ORG)

4. Query Data: influxdb://query/{orgName}/{fluxQuery}

   • Executes a Flux query and returns results as JSON (headers and one record per row, across all result tables)

Template variables (bucketName, orgName, fluxQuery) must be percent-encoded, e.g. with encodeURIComponent, so names containing spaces or / and multi-line queries survive the URI.

Tools

The server provides these tools:

1. write-data: Write time-series data in line protocol format

   • Parameters: org, bucket, data, precision (optional)
   • org and bucket are optional when INFLUXDB_ORG / INFLUXDB_BUCKET are set, and fall back to those values

2. query-data: Execute Flux queries

   • Parameters: org, query
   • org is optional when INFLUXDB_ORG is set, and falls back to that value

3. create-bucket: Create a new bucket

   • Parameters: name, orgID, retentionPeriodSeconds (optional, whole seconds; omit or pass 0 for infinite retention)

4. create-org: Create a new organization

   • Parameters: name, description (optional)

Prompts

The server offers these prompt templates:

1. flux-query-examples: Common Flux query examples
2. line-protocol-guide: Guide to InfluxDB line protocol format

Configuration

The server requires these environment variables:

• INFLUXDB_TOKEN (required): Authentication token for the InfluxDB API
• INFLUXDB_URL (optional): URL of the InfluxDB instance (defaults to http://localhost:8086)
• INFLUXDB_ORG (optional): Default organization name for certain operations. When set, org becomes optional on the write-data and query-data tools
• INFLUXDB_BUCKET (optional): Default bucket name. When set, bucket becomes optional on the write-data tool
• DEBUG (optional): Set to mcp:* to log every MCP message to stderr. This includes query text and written data, so leave it off in production

The following variables apply only to the Streamable HTTP transport (see HTTP transport security):

• MCP_HTTP_HOST (optional): Interface to listen on (defaults to 127.0.0.1; same as --host)
• MCP_AUTH_TOKEN (optional): When set, every request must send Authorization: Bearer <token>. Required to listen on a non-loopback interface
• MCP_ALLOWED_HOSTS (optional): Comma-separated hostnames (ports are ignored) accepted in the Host header. Defaults to localhost,127.0.0.1,[::1] plus the bind address on loopback; unset means no `

... View full README on GitHub