InfluxDB MCP Server

This is a Model Context Protocol (MCP) server designed to provide access to an InfluxDB instance using the InfluxDB OSS API v2. It was primarily developed with Claude Code.

Features

The MCP server offers:

• Resources: Access to organization, bucket, and measurement data within InfluxDB.
• Tools: Functionality to write data, execute queries, and manage database objects like buckets and organizations.
• Prompts: Templates for common Flux queries and a guide to the Line Protocol format.

Resources

The server exposes resources like: influxdb://orgs for organizations, influxdb://buckets for buckets, influxdb://bucket/{bucketName}/measurements for measurements in a bucket, and influxdb://query/{orgName}/{fluxQuery} to execute Flux queries.

Tools

Tools include write-data (writes line protocol data), query-data (executes Flux queries), create-bucket (creates new buckets), and create-org (creates new organizations).

Prompts

Provides flux-query-examples and line-protocol-guide for assistance.

Configuration

Requires INFLUXDB_TOKEN and optionally INFLUXDB_URL, and INFLUXDB_ORG environment variables.

Installation

Provides instructions for running with npx, global installation via npm, or from source.

Integration with Claude for Desktop

Provides configuration examples for claude_desktop_config.json.

Code Structure

Details the modular code structure, including directories for configuration, utilities, handlers, and prompts.

Testing

Includes integration tests that use Docker to test server functionality.

License

MIT