Database · MODEL CONTEXT PROTOCOL

influxdb-mcp-server

An MCP Server for querying InfluxDB

WHAT IT CONNECTS

influxdb-mcp-server 为 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

MCP 收录不等于安全审核

MCP 服务器可能获得模型上下文、凭据、本地文件或调用外部系统的权限。连接 Agent 前,请检查代码、环境变量、网络行为、软件包来源与维护状态。