InfluxDB 3 MCP Server 是 InfluxDB 3 集成的模型上下文协议（MCP）服务器，由 InfluxDB 官方维护。它为 MCP 客户端提供工具、资源和提示词，用于与 InfluxDB 3 Core、Enterprise、Cloud Dedicated、Clustered 以及 Cloud Serverless 进行交互。
用途 该服务器的主要用途是让 AI 代理或 MCP 客户端能够安全地探索和查询 InfluxDB 3 数据库。它可以用于只读工作流，例如分析师探索陌生数据库，或运维人员排查 InfluxQL 仪表板查询。通过配置只读配置（INFLUX_MCP_TOOL_PROFILE=readonly），客户端可以在不暴露写入、管理、令牌管理或主机级工具的情况下，仅执行查询与数据探索。
主要能力 服务器提供工具、资源和提示词三类能力。可用工具包括 list_databases、list_tables、describe_table、query_sql、query_influxql、get_help 等，支持结构化 JSON 输出、请求与查询关联元数据（如 request_id、query_id、query_id_source）、行数、截断状态和警告信息。只读模式下，代理可以列出可访问数据库、发现测量与列、构建有界 SQL 查询并执行，同时对不确定的标签和字段类别标记为 unknown。运维人员可以使用 InfluxQL 查询、SHOW 查询和模式发现来验证测量与列，采样最近行以区分数据缺失与查询错误，并拒绝不安全的后续操作（如 SELECT INTO 或破坏性语句）。
使用方式 使用前需要提供环境变量，包括 INFLUX_DB_INSTANCE_URL、INFLUX_DB_TOKEN 和 INFLUX_DB_PRODUCT_TYPE。对于 Cloud Dedicated，需要 INFLUX_DB_PRODUCT_TYPE=cloud-dedicated 和 INFLUX_DB_CLUSTER_ID，以及数据库令牌或管理令牌或两者。对于 Clustered，需要 INFLUX_DB_PRODUCT_TYPE=clustered 和 INFLUX_DB_INSTANCE_URL，以及相应令牌组合。该服务器支持本地构建、npx 和 Docker 部署方式。集成时，先安装依赖（npm install），再构建（npm run build），然后配置 MCP 客户端使用构建后的服务器。示例配置可在 example-local.mcp.json、example-npx.mcp.json、example-docker.mcp.json 等文件中找到。仓库还提供了 env.example、env.cloud-dedicated.example、env.clustered.example 和 env.cloud-serverless.example 等环境变量模板。
适用场景 适用于需要让 AI 代理与 InfluxDB 3 交互的场景，例如数据分析、数据库探索、查询调试、仪表板故障排查等。只读模式特别适合安全要求较高的探索性分析，避免意外修改数据。
限制 使用需要 Node.js v20.11 或更高版本、npm v9 或更高版本（用于 npm/npx 方式）以及 Docker（用于 Docker 方式）。只读模式需要设置 INFLUX_MCP_TOOL_PROFILE=readonly。工具调用遥测默认启用，输出结构化 JSON 到 stderr，不记录 API 令牌、请求头、工具参数或查询文本。对于 Core 连接，不支持资源令牌工具，仅 Enterprise 支持资源令牌。
其他信息 关于定价、收费、具体平台限制、效果承诺等信息，当前资料暂未提供。
