InfluxDB

Unified MCP server providing tools, resources, and prompts to interact with InfluxDB v3 deployments via MCP clients.

javascript

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "quorralyne-mcp_test_server": {
      "command": "node",
      "args": [
        "/path/to/influx-mcp-standalone/build/index.js"
      ],
      "env": {
        "INFLUX_DB_TOKEN": "<YOUR_INFLUXDB_TOKEN>",
        "INFLUX_DB_INSTANCE_URL": "http://localhost:8181/",
        "INFLUX_DB_PRODUCT_TYPE": "core"
      }
    }
  }
}

You run an MCP server that bridges InfluxDB with MCP clients, enabling you to execute data operations, manage databases, run queries, and inspect measurements through a consistent, programmable interface. This guide walks you through using the InfluxDB MCP Server, installing it, and configuring it for local, containerized, or remote InfluxDB deployments.

How to use

With the InfluxDB MCP Server, you expose a set of tools and resources to MCP clients. You can perform core data operations such as querying data, writing data in line protocol, and listing databases and measurements. You can also manage tokens and database configurations if you are running a Core/Enterprise or Cloud-Dedicated setup. Use your MCP client to call the available tools and resources to accomplish tasks like querying data, creating or deleting databases, viewing schemas for measurements, and checking health status.

How to install

Prerequisites you need before running the server are an InfluxDB instance, Node.js, npm, and optional Docker for containerized setups.

Install steps (local development):

npm install

Build the server for local usage

Create an MCP client configuration that points to the server, using one of the provided examples for your environment.

Additional notes

Environment variables define how the server connects to InfluxDB. You provide either Core/Enterprise credentials or Cloud-Dedicated tokens depending on your deployment. See the configured environment variables for details.

Examples of environment variable configurations demonstrate both local and cloud-dedicated setups. Use the appropriate combination of cluster and token values for your InfluxDB deployment.

Using MCP clients with the InfluxDB server

You will typically set up a local MCP client, an npx-based workflow, or a Docker-based workflow. In each case you specify the MCP server to run and provide the required environment variables so the server can reach your InfluxDB instance and authenticate correctly.

Available tools

get_help

Get help and troubleshooting guidance for InfluxDB operations

write_line_protocol

Write data using InfluxDB line protocol

create_database

Create a new database with optional Cloud Dedicated config options

update_database

Update database configuration such as maxTables and retention (Cloud Dedicated only)

delete_database

Delete a database by name

execute_query

Run a SQL query against a database in multiple formats

get_measurements

List all measurements in a database

get_measurement_schema

Get schema details (columns and types) for a measurement

create_admin_token

Create a new admin token with full permissions (Core/Enterprise only)

list_admin_tokens

List all admin tokens with optional filtering (Core/Enterprise only)

create_resource_token

Create a resource token for specific databases and permissions (Core/Enterprise only)

list_resource_tokens

List all resource tokens with filtering and ordering (Core/Enterprise only)

delete_token

Delete a token by name (Core/Enterprise only)

regenerate_operator_token

Regenerate the operator token (dangerous/irreversible) (Core/Enterprise only)

cloud_list_database_tokens

List all database tokens for Cloud-Dedicated cluster (Cloud Dedicated only)

cloud_get_database_token

Get details of a specific database token by ID (Cloud Dedicated only)

cloud_create_database_token

Create a new database token for Cloud-Dedicated cluster (Cloud Dedicated only)

cloud_update_database_token

Update an existing database token (Cloud Dedicated only)

cloud_delete_database_token

Delete a database token from Cloud-Dedicated cluster (Cloud Dedicated only)

list_databases

List all available databases in the instance

health_check

Check InfluxDB connection and health status

Built by

VeilStrat

AI signals for GTM teams