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:

Organizations List: influxdb://orgs
- Displays all organizations in the InfluxDB instance
Buckets List: influxdb://buckets
- Shows all buckets with their metadata
Bucket Measurements: influxdb://bucket/{bucketName}/measurements
- Lists all measurements within a specified bucket
Query Data: influxdb://query/{orgName}/{fluxQuery}
- Executes a Flux query and returns results as a resource

Tools

The server provides these tools:

write-data: Write time-series data in line protocol format
- Parameters: org, bucket, data, precision (optional)
query-data: Execute Flux queries
- Parameters: org, query
create-bucket: Create a new bucket
- Parameters: name, orgID, retentionPeriodSeconds (optional)
create-org: Create a new organization
- Parameters: name, description (optional)

Prompts

The server offers these prompt templates:

flux-query-examples: Common Flux query examples
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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

A Model Context Protocol server that provides Claude with access to InfluxDB time-series database instances, enabling data writing, querying, and management of organizations and buckets through natural language.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Snowflake Service
datawiz168
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to execute SQL queries on Snowflake databases with automatic connection lifecycle management.
Last updated -
41
Python
MIT License
MCP Deep Web Research Server
PedroDnT
A
security
A
license
A
quality
A Model Context Protocol server that enables Claude to perform advanced web research with intelligent search queuing, enhanced content extraction, and deep research capabilities.
Last updated -
3
8
1
TypeScript
MIT License
Firestore Advanced MCP
diez7lm
-
security
A
license
-
quality
A Model Context Protocol server that enables large language models like Claude to perform comprehensive interactions with Firebase Firestore databases, supporting full CRUD operations, complex queries, and advanced features like transactions and TTL management.
Last updated -
2
4
JavaScript
MIT License
MCP SQL Server
JubinSaniei
-
security
F
license
-
quality
A Model Context Protocol server that allows Large Language Models like Claude to execute SQL queries, explore database schemas, and maintain persistent connections to SQL Server databases.
Last updated -
TypeScript

View all related MCP servers

InfluxDB MCP Server