mcflux

Read-only MCP server for InfluxDB v1. Lets Claude (Desktop or Code) query and explore your time-series data through the Model Context Protocol.

Tools

Write operations (CREATE, DROP, DELETE, INSERT, etc.) are blocked at the server level.

Related MCP server: InfluxDB MCP Server

Requirements

• Python 3.10+

• uv package manager

• An InfluxDB v1 instance

Installation

Claude Desktop (extension)

Download the latest .mcpb from Releases, then:

1. Open Claude Desktop

2. Go to Settings > Extensions > Advanced settings

3. Click Install Extension and select the .mcpb file

4. Fill in your InfluxDB URL, username, and password in the configuration form

Claude Desktop (manual)

Add to claude_desktop_config.json:

• Windows: %AppData%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "influxdb": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcflux", "run", "server.py"],
      "env": {
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_USERNAME": "myuser",
        "INFLUXDB_PASSWORD": "mypass"
      }
    }
  }
}

Claude Code

Add to .claude/settings.json or your project settings:

{
  "mcpServers": {
    "influxdb": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcflux", "run", "server.py"],
      "env": {
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_USERNAME": "myuser",
        "INFLUXDB_PASSWORD": "mypass"
      }
    }
  }
}

Configuration

Omit INFLUXDB_USERNAME and INFLUXDB_PASSWORD if your instance does not require authentication.

Building the .mcpb bundle

npm install -g @anthropic-ai/mcpb
mcpb pack .

This produces a mcflux.mcpb file that can be installed as a Claude Desktop extension.

License

MIT