mcflux

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

| Tool | Description | |------|-------------| | ping | Check connectivity and return the InfluxDB version | | list_databases | List all databases | | list_measurements | List measurements in a database | | list_tag_keys | List tag keys, optionally filtered by measurement | | list_field_keys | List field keys and their types | | list_tag_values | List values for a specific tag key | | query | Execute a read-only InfluxQL query (SELECT/SHOW only) |

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

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

| Environment variable | Required | Default | Description | |---------------------|----------|---------|-------------| | INFLUXDB_URL | No | http://localhost:8086 | InfluxDB HTTP API URL | | INFLUXDB_USERNAME | No | (none) | Username for basic auth | | INFLUXDB_PASSWORD | No | (none) | Password for basic auth |

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