InfluxDB MCP Server

by m4tyn0

Integrations

  • 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

  1. Clone the repository:
    git clone https://github.com/m4tyn0/influx_mcp cd influxdb-mcp-server
  2. Create a .env file with your configuration :
    cp env.example .env
    INFLUXDB_HOST= INFLUXDB_PORT=8086 INFLUXDB_USERNAME= INFLUXDB_PASSWORD= INFLUXDB_SSL=false INFLUXDB_VERIFY_SSL=true INFLUXDB_TIMEOUT=10 JWT_SECRET= JWT_ALGORITHM=HS256
  3. Build 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:

import jwt import datetime # Create a token payload = { "sub": "username", # Replace with the username you want to identify with "iat": datetime.datetime.utcnow(), "exp": datetime.datetime.utcnow() + datetime.timedelta(hours=1) } token = jwt.encode(payload, "your-jwt-secret", algorithm="HS256") print(token)

Save this token for use with your MCP client.

Using with MCP Clients

  1. Authenticate with the MCP server using the JWT token:
    Tool: auth Arguments: {"token": "your.jwt.token.here"}
  2. 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:

  1. 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
  2. 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
  3. 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
-
security - not tested
F
license - not found
-
quality - not tested

A Model Context Protocol server that provides secure, read-only access to time-series data stored in InfluxDB 1.8 via JWT authentication.

  1. Overview
    1. Prerequisites
      1. Installation
        1. JWT Authentication
          1. Using with MCP Clients
            1. Troubleshooting
              1. Security Notes
                1. 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

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                A 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 -
                2
                TypeScript
              • A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that allows creation and management of multiple Fireproof JSON databases with CRUD operations, querying capabilities, and cloud synchronization for sharing databases with others.
                Last updated -
                9
                2
                JavaScript
                • Apple
              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server for accessing Confluence API using Personal Access Tokens, enabling users to retrieve space lists, view pages, create new pages, and update existing content.
                Last updated -
                TypeScript
              • A
                security
                A
                license
                A
                quality
                A 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 -
                4
                12
                3
                JavaScript
                MIT License

              View all related MCP servers

              ID: 7es3qwxn82