InfluxDB MCP Server

Name: InfluxDB MCP Server
Author: idoru

@idoru

代码仓库

关于 InfluxDB MCP Server

An MCP Server for querying InfluxDB

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

idoru

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "influxdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@idoru/influxdb-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

工具

org, bucket, data, precision (optional)

org, query

name, orgID, retentionPeriodSeconds (optional)

name, description (optional)

概览

What is InfluxDB MCP Server?

InfluxDB MCP Server is a Model Context Protocol server that exposes access to an InfluxDB v2 instance through the InfluxDB OSS API v2. It provides resources for browsing organizations, buckets, and measurements, tools for writing data and executing Flux queries, and prompt templates for common database operations.

How to use InfluxDB MCP Server?

Set the INFLUXDB_TOKEN environment variable, optionally configure INFLUXDB_URL (defaults to http://localhost:8086) and INFLUXDB_ORG, then run the server via npx influxdb-mcp-server. The server uses stdio transport by default and can also start with Streamable HTTP transport using the --http flag. Add it to your MCP client configuration, such as claude_desktop_config.json.

Key features of InfluxDB MCP Server

Resources for listing organizations, buckets, and measurements
Tools to write time-series data and execute Flux queries
Tools to create new buckets and organizations
Prompt templates for common Flux queries and Line Protocol format
Configurable HTTP or stdio transport modes
Modular code structure with separation of concerns

Use cases of InfluxDB MCP Server

Querying time-series metrics from an InfluxDB instance through an AI assistant
Writing sensor or IoT data in Line Protocol format programmatically
Managing InfluxDB organizations and buckets via natural language commands
Exploring database schema and measurement structures interactively

FAQ from InfluxDB MCP Server

What environment variables are required to run the server?

INFLUXDB_TOKEN is required. INFLUXDB_URL (default http://localhost:8086) and INFLUXDB_ORG are optional.

How do I install or run InfluxDB MCP Server?

Run directly with npx (INFLUXDB_TOKEN=your_token npx influxdb-mcp-server), install globally via npm, or clone and run from source. Smithery installation for Claude Desktop is also supported.

What transport options does the server support?

The server supports stdio transport (default) and Streamable HTTP transport via the --http flag, optionally specifying a port (defaults to 3000).

How do I integrate InfluxDB MCP Server with Claude Desktop?

Add an entry to claude_desktop_config.json under mcpServers using npx or a local path, with the required environment variables.

What can I access and manage with this server?

List organizations and buckets, view measurements within a bucket, execute Flux queries, write data in Line Protocol format, and create new buckets or organizations.