A
licenseNot graded
qualityD
maintenanceAn MCP server implementation that enables Claude to execute read-only queries against MariaDB databases and explore database schemas through natural language.
20
MIT
mcflux
by dmayan-ss
Provides tools to query and explore time-series data in an InfluxDB v1 instance, including listing databases, measurements, tag keys, field keys, tag values, and executing read-only InfluxQL queries.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcflux list databases"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Check connectivity and return the InfluxDB version |
| List all databases |
| List measurements in a database |
| List tag keys, optionally filtered by measurement |
| List field keys and their types |
| List values for a specific tag key |
| Execute a read-only InfluxQL query (SELECT/SHOW only) |
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:
Open Claude Desktop
Go to Settings > Extensions > Advanced settings
Click Install Extension and select the
.mcpbfileFill 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.jsonmacOS:
~/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 |
| No |
| InfluxDB HTTP API URL |
| No | (none) | Username for basic auth |
| 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
Available Tools
7 toolslist_databasesA
List all databases on the InfluxDB instance.
Inputs: no named parameters. Returns: result
list_field_keysA
List field keys and their types in a database, optionally filtered by measurement.
Args: database: Name of the InfluxDB database. measurement: Optional measurement name to filter by.
Inputs: database (required), measurement. Returns: result
list_measurementsA
List all measurements in a database.
Args: database: Name of the InfluxDB database.
Inputs: database (required). Returns: result
list_tag_keysA
List tag keys in a database, optionally filtered by measurement.
Args: database: Name of the InfluxDB database. measurement: Optional measurement name to filter by.
Inputs: database (required), measurement. Returns: result
list_tag_valuesA
List values for a specific tag key.
Args: database: Name of the InfluxDB database. tag_key: The tag key whose values you want to list. measurement: Optional measurement name to filter by.
Inputs: tag_key (required), database (required), measurement. Returns: result
pingA
Check connectivity to the InfluxDB instance. Returns the server version.
Inputs: no named parameters. Returns: result
queryA
Execute a read-only InfluxQL query against a database.
Only SELECT and SHOW statements are allowed. Write operations are blocked.
Args: database: Name of the InfluxDB database to query. influxql: The InfluxQL query to execute (e.g. SELECT * FROM cpu LIMIT 10). epoch: Timestamp precision in the response (ns, u, ms, s, m, h). Default: ms.
Inputs: database (required), influxql (required), epoch. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A4.2/5.0
Scored across 7 tools
Disambiguation5/5
Each tool has a distinct purpose: ping for connectivity, list_* tools for schema exploration (databases, measurements, tags, fields), and query for executing InfluxQL. No overlapping functionality.
Naming Consistency4/5
Most tools follow the verb_noun pattern (list_databases, list_measurements, etc.). 'ping' and 'query' are exceptions but are standard, recognizable verbs in this context, so naming remains predictable.
Tool Count5/5
Seven tools is well within the ideal range for a focused server. Each tool addresses a core aspect of read-only InfluxDB interaction without redundancy.
Completeness5/5
The toolset covers the full read-only lifecycle: connectivity, database listing, schema exploration (measurements, tags, fields), and querying. Any missing metadata can be obtained through the query tool with SHOW statements.
Maintenance
ActivityInactive
ResponsivenessOutdated data
Related MCP Connectors
Text-to-SQL MCP server: read-only queries on PostgreSQL, MySQL and SQL Server with your real schema
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Hosted SQL Server MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Read-only Google Analytics 4 MCP server for AI assistants.
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol server that provides Claude with access to InfluxDB time-series database instances, enabling data writing, querying, and management of organizations and buckets through natural language.4238 npm49MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables interactions with InfluxDB's open-source time-series database API, allowing data querying, management, and operations through natural language.-
- AlicenseAqualityDmaintenanceA read-only MCP server for SQL Server database introspection that enables Claude to explore and query databases via tools like listing objects and executing SELECT queries.20MIT