InfluxDB
About
Connects to InfluxDB time-series databases for querying measurements, writing data, and managing buckets through a bridge that exposes database functionality via tools and resources.
Details
- Author
- idoru
- Repository
- idoru/influxdb-mcp-server
- GitHub stars
- 5
- Downloads
- 332
- License
- MIT License
- Categories
- Database, Infrastructure, Other, Productivity, Developer Tools, Design, AI, Search, Security, Project Management
- Tags
- #integration
Jump to
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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
InfluxDBCommand (node, npx, python, etc.)npxArguments-
Argument 1
influxdb-mcp-server
Environment-
INFLUXDB_ORG
your_org -
INFLUXDB_URL
http://localhost:8086 -
INFLUXDB_TOKEN
your_token
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install InfluxDB MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claude
npm install -g influxdb-mcp-server
npm install
{
"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"
}
}
}
}
```
write-data
Write time-series data in line protocol format. Parameters: org (string), bucket (string), data (string), precision (optional string)
query-data
Execute Flux queries. Parameters: org (string), query (string)
create-bucket
Create a new bucket. Parameters: name (string), orgID (string), retentionPeriodSeconds (optional number)
create-org
Create a new organization. Parameters: name (string), description (optional string)
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)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"influxdb": {
"env": {
"INFLUXDB_ORG": "your_org",
"INFLUXDB_URL": "http://localhost:8086",
"INFLUXDB_TOKEN": "your_token"
},
"args": [
"influxdb-mcp-server"
],
"command": "npx"
}
}
}Linux
{
"env": {
"INFLUXDB_ORG": "your_org",
"INFLUXDB_URL": "http://localhost:8086",
"INFLUXDB_TOKEN": "your_token"
},
"args": [
"influxdb-mcp-server"
],
"command": "npx"
}Macos
{
"env": {
"INFLUXDB_ORG": "your_org",
"INFLUXDB_URL": "http://localhost:8086",
"INFLUXDB_TOKEN": "your_token"
},
"args": [
"influxdb-mcp-server"
],
"command": "npx"
}Windows
{
"env": {
"INFLUXDB_ORG": "your_org",
"INFLUXDB_URL": "http://localhost:8086",
"INFLUXDB_TOKEN": "your_token"
},
"args": [
"/c",
"npx",
"influxdb-mcp-server"
],
"command": "cmd"
}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
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)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
