InfluxDB

What is InfluxDB MCP Server?

InfluxDB MCP Server is a Model Context Protocol (MCP) server that provides access to an InfluxDB instance using the InfluxDB OSS API v2. It allows users to interact with InfluxDB for querying, writing data, and managing database objects through a standardized MCP interface.

How to use InfluxDB MCP Server?

InfluxDB MCP Server can be installed and run in several ways:

• Via Smithery: Use npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claude for automatic installation with Claude Desktop.
• Run with npx: Execute INFLUXDB_TOKEN=your_token npx influxdb-mcp-server.
• Install globally: Install via npm install -g influxdb-mcp-server and then run INFLUXDB_TOKEN=your_token influxdb-mcp-server.
• From source: Clone the repository, install dependencies with npm install, and run with INFLUXDB_TOKEN=your_token npm start.

For integration with Claude for Desktop, configure mcpServers in your claude_desktop_config.json with the appropriate command and environment variables (e.g., INFLUXDB_TOKEN, INFLUXDB_URL, INFLUXDB_ORG).

Key Features of InfluxDB MCP Server

• Resources:
  • influxdb://orgs: Displays all organizations.
  • influxdb://buckets: Shows all buckets with metadata.
  • influxdb://bucket/{bucketName}/measurements: Lists measurements within a specified bucket.
  • influxdb://query/{orgName}/{fluxQuery}: Executes a Flux query and returns results.
• Tools:
  • write-data: Writes time-series data in line protocol format.
  • query-data: Executes Flux queries.
  • create-bucket: Creates a new bucket.
  • create-org: Creates a new organization.
• Prompts:
  • flux-query-examples: Provides common Flux query examples.
  • line-protocol-guide: Offers a guide to InfluxDB line protocol format.

Use Cases of InfluxDB MCP Server

• Time-series data management: Efficiently write and query time-series data in InfluxDB.
• Database object management: Programmatically create and manage InfluxDB organizations and buckets.
• Integration with AI models: Provides a structured interface for AI models (like Claude) to interact with InfluxDB, enabling them to retrieve and manipulate time-series data for various applications.
• Automated data workflows: Facilitates the creation of automated workflows that involve InfluxDB data, such as data ingestion, analysis, and reporting.

FAQ from InfluxDB MCP Server

Q: What environment variables are required for InfluxDB MCP Server? A: The INFLUXDB_TOKEN is required for authentication. INFLUXDB_URL (defaults to http://localhost:8086) and INFLUXDB_ORG are optional.

Q: How can I test InfluxDB MCP Server? A: The repository includes comprehensive integration tests. You can run them using npm test. These tests spin up a Docker container with InfluxDB, populate it with sample data, and test all MCP server functionality.

InfluxDB MCP Server

A Model Context Protocol (MCP) server that exposes access to an InfluxDB 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

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

   • Executes a Flux query and returns results as a resource

Tools

The server provides these tools:

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

   • Parameters: org, bucket, data, precision (optional)

2. query-data: Execute Flux queries

   • Parameters: org, query

3. create-bucket: Create a new bucket

   • Parameters: name, orgID, retentionPeriodSeconds (optional)

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

Installation

Installing via Smithery

To install InfluxDB MCP Server for Claude Desktop automatically via Smithery:

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

Option 1: Run with npx (recommended)

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

Option 2: Install globally

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

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

Option 3: From source

# 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

Integration with Claude for Desktop

Add the server to your claude_desktop_config.json:

Using npx (recommended)

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

If installed locally

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

Code Structure

The server code is organized into a modular structure:

• src/
  • index.js - Main server entry point
  • config/ - Configuration related files
    • env.js - Environment variable handling
  • utils/ - Utility functions
    • influxClient.js - InfluxDB API client
    • loggerConfig.js - Console logger configuration
  • handlers/ - Resource and tool handlers
    • organizationsHandler.js - Organizations listing
    • bucketsHandler.js - Buckets listing
    • measurementsHandler.js - Measurements listing
    • queryHandler.js - Query execution
    • writeDataTool.js - Data write tool
    • queryDataTool.js - Query tool
    • createBucketTool.js - Bucket creation tool
    • createOrgTool.js - Organization creation tool
  • prompts/ - Prompt templates
    • fluxQueryExamplesPrompt.js - Flux query examples
    • lineProtocolGuidePrompt.js - Line protocol guide

This structure allows for better maintainability, easier testing, and clearer separation of concerns.

Testing

The repository includes comprehensive integration tests that:

• Spin up a Docker container with InfluxDB
• Populate it with sample data
• Test all MCP server functionality

To run the tests:

npm test

License

MIT