Database · MODEL CONTEXT PROTOCOL
influxdb-mcp-server
An MCP Server for querying InfluxDB
WHAT IT CONNECTS
What influxdb-mcp-server gives an AI Agent
- **Resources**: Access to organization, bucket, and measurement data
- **Tools**: Write data, execute queries, and manage database objects
- **Prompts**: Templates for common Flux queries and Line Protocol format
- **Organizations List**: `influxdb://orgs`
- Displays all organizations in the InfluxDB instance
- **Buckets List**: `influxdb://buckets`
- Shows all buckets with their metadata
- **Bucket Measurements**: `influxdb://bucket/{bucketName}/measurements`
- Lists all measurements within a specified bucket
- **Query Data**: `influxdb://query/{orgName}/{fluxQuery}`
- Executes a Flux query and returns results as a resource
- `write-data`: Write time-series data in line protocol format
- Parameters: org, bucket, data, precision (optional)
- `query-data`: Execute Flux queries
- Parameters: org, query
- `create-bucket`: Create a new bucket
- Parameters: name, orgID, retentionPeriodSeconds (optional)
- `create-org`: Create a new organization
- Parameters: name, description (optional)
- `flux-query-examples`: Common Flux query examples
- `line-protocol-guide`: Guide to InfluxDB line protocol format
- `INFLUXDB_TOKEN` (required): Authentication token for the InfluxDB API
- `INFLUXDB_URL` (optional): URL of the InfluxDB instance (defaults to `http://localhost:8086`)
- `INFLUXDB_ORG` (optional): Default organization name for certain operations
- `src/`
- `index.js` - Main server entry point
- `config/` - Configuration related files
- `env.js` - Environment variable handling
- `utils/` - Utility functions
- `influxClient.js` - InfluxDB API client
- `loggerConfig.js` - Console logger configuration
- `handlers/` - Resource and tool handlers
- `organizationsHandler.js` - Organizations listing
- `bucketsHandler.js` - Buckets listing
- `measurementsHandler.js` - Measurements listing
- `queryHandler.js` - Query execution
- `writeDataTool.js` - Data write tool
- `queryDataTool.js` - Query tool
- `createBucketTool.js` - Bucket creation tool
- `createOrgTool.js` - Organization creation tool
- `prompts/` - Prompt templates
- `fluxQueryExamplesPrompt.js` - Flux query examples
- `lineProtocolGuidePrompt.js` - Line protocol guide
- Spin up a Docker container with InfluxDB
- Populate it with sample data
- Test all MCP server functionality
SECURITY
An MCP listing is not a security review
An MCP server may receive model context, credentials, local files, or permission to call external systems. Review its code, requested environment variables, network behavior, package provenance, and maintenance status before connecting it to an agent.