Provides secure, read-only access to InfluxDB 1.8 time-series data via a standardized interface, allowing AI assistants to query databases, list measurements, and execute SELECT queries with JWT authentication.
InfluxDB MCP Server
A Model Context Protocol (MCP) server that provides secure, read-only access to InfluxDB 1.8 via JWT authentication.
Overview
InfluxDB MCP Server allows AI assistants to query time-series data stored in InfluxDB through a standardized interface. It provides read-only access to your InfluxDB instance with authentication via JWT tokens.
Prerequisites
Docker
InfluxDB 1.8 instance (already running)
Credentials for your InfluxDB instance
Installation
Clone the repository:
git clone https://github.com/m4tyn0/influx_mcp cd influxdb-mcp-serverCreate a with your configuration :
cp env.example .envINFLUXDB_HOST= INFLUXDB_PORT=8086 INFLUXDB_USERNAME= INFLUXDB_PASSWORD= INFLUXDB_SSL=false INFLUXDB_VERIFY_SSL=true INFLUXDB_TIMEOUT=10 JWT_SECRET= JWT_ALGORITHM=HS256Build and run the Docker container:
docker build -t influxdb-mcp-server . docker run -d --env-file .env -p 8000:8000 influxdb-mcp-server
JWT Authentication
The server uses JWT tokens for authentication. You need to generate a token to authenticate with the MCP server, here is a simple script to do that:
Save this token for use with your MCP client.
Using with MCP Clients
Authenticate with the MCP server using the JWT token:
Tool: auth Arguments: {"token": "your.jwt.token.here"}Query your InfluxDB data:
Tool: list_databases Arguments: {}Tool: list_measurements Arguments: {"database": "your_database_name"}Tool: query Arguments: { "database": "your_database_name", "query": "SELECT * FROM measurement_name LIMIT 10" }
Troubleshooting
If you encounter issues:
Connection errors to InfluxDB:
Verify the INFLUXDB_HOST is correct and accessible from the Docker container
Check that your InfluxDB credentials are correct
Ensure your InfluxDB instance is configured to accept connections from external hosts
Authentication issues:
Verify your JWT_SECRET is set correctly
Ensure the token you're using matches the JWT_SECRET and hasn't expired
Check that your InfluxDB credentials have read access to the databases
Check logs:
docker logs
Security Notes
The MCP server only allows read-only access to your InfluxDB instance
All queries are validated to ensure they begin with SELECT
JWT authentication protects access to the MCP server
Consider running the server in a private network for additional security
Thank you for working with me. If you have any issues with the code, or want more things built, hit me up: m4tyn0@gmail.com
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that provides secure, read-only access to time-series data stored in InfluxDB 1.8 via JWT authentication.
Related MCP Servers
- -securityFlicense-qualityA secure Model Context Protocol server that manages time-based operations using timing attack protection and timelock encryption, allowing for timed interval management and secure data storage.Last updated -3
- AsecurityAlicenseAqualityA Model Context Protocol server that provides read-only access to MongoDB databases, enabling AI assistants to directly query and analyze MongoDB data while maintaining data safety.Last updated -14617MIT License
- -securityAlicense-qualityA Model Context Protocol server that provides read-only access to MySQL databases, enabling LLMs to inspect database schemas and execute read-only queries.Last updated -3,401MIT License
- AsecurityAlicenseAqualityA 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.Last updated -43826MIT License