使用 InfluxDB 3 MCP 服务器
InfluxDB 模型上下文协议 (MCP) 服务器 让您可以使用大型语言模型 (LLM) 代理以自然语言与 InfluxDB 3 Core 进行交互。它能够以纯英文进行数据库管理、令牌处理和 SQL 查询生成——无需编写代码。
本指南将引导您配置 LLM 代理以运行和使用 InfluxDB MCP 服务器，从而与您的 InfluxDB 3 Core 服务器进行交互。
前提条件
Node.js v18+ (如果使用
npx运行 MCP 服务器)Docker (如果使用 Docker 运行 MCP 服务器)
一个正在运行且可访问的 InfluxDB 3 Core 服务器。
一个有效的 InfluxDB 3 Core 管理员令牌
(可选) 像 Claude Desktop、ChatGPT Desktop 等 LLM 助手。
配置 MCP 服务器
使用环境变量配置 InfluxDB 3 MCP 服务器并将其连接到您的 InfluxDB 3 Core 服务器。启动 MCP 服务器时设置以下环境变量
必需的 InfluxDB 连接变量
INFLUX_DB_PRODUCT_TYPE:
coreINFLUX_DB_INSTANCE_URL: 您的 InfluxDB 3 Core URL——例如
https://:8181如果使用 Docker 运行 InfluxDB MCP 服务器，并且您想管理一个在
localhost上运行的 InfluxDB 实例，请使用内部 Docker 网络连接到您的本地 InfluxDB 3 Core 服务器——例如http://host.docker.internal:8181/INFLUX_DB_TOKEN: 您的 InfluxDB 3 Core 管理员令牌
配置您的 LLM 代理以运行 MCP 服务器
要运行 MCP，请使用 Node.js 和 npm 或 Docker 来运行服务器。一些 LLM 代理，如 Claude Desktop，可以为您启动、运行和连接到 MCP 服务器
以下说明提供了有关如何配置 Claude Desktop 以使用 InfluxDB MCP 服务器的信息。
从 GitHub 克隆 influxdata/influxdb3_mcp_server 存储库。
导航到
influxdb3_mcp_server项目目录cd influxdb3_mcp_server/安装依赖项
npm install构建 MCP 服务器
npm run build
这将构建运行 MCP 服务器所需的文件，并将它们存储在 ./build 中。./build/index.js 文件启动 MCP 服务器。
配置您的 LLM 代理以使用基于 Node.js 的 MCP 服务器
在 Claude Desktop 中，转到 Settings > Developers 并编辑您的配置。输入以下 JSON 配置
{
"mcpServers": {
"influxdb": {
"command": "node",
"args": ["/path/to/influxdb3_mcp_server/build/index.js"],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "core",
"INFLUX_DB_INSTANCE_URL": "https://:8181",
"INFLUX_DB_TOKEN": "AUTH_TOKEN"
}
}
}
}替换以下内容：
path/to: 您的influxdb3_mcp_server项目目录的绝对路径。AUTH_TOKEN: 您的 InfluxDB 3 Core 令牌。令牌授予的权限决定了您的 LLM 代理可以执行的操作。
配置您的 LLM 代理以使用基于 Docker 的 MCP 服务器
在 Claude Desktop 中，转到 Settings > Developers 并编辑您的配置。输入以下 JSON 配置
在下面的示例中，替换以下内容
path/to: 您的influxdb3_mcp_server项目目录的绝对路径。AUTH_TOKEN: 您的 InfluxDB 3 Core 令牌。令牌授予的权限决定了您的 LLM 代理可以执行的操作。
连接到远程 InfluxDB 服务器
{
"mcpServers": {
"influxdb": {
"command": "docker",
"args": [
"run",
"--rm",
"--interactive",
"--env",
"INFLUX_DB_PRODUCT_TYPE",
"--env",
"INFLUX_DB_INSTANCE_URL",
"--env",
"INFLUX_DB_TOKEN",
"influxdata/influxdb3-mcp-server"
],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "core",
"INFLUX_DB_INSTANCE_URL": "https://:8181",
"INFLUX_DB_TOKEN": "AUTH_TOKEN"
}
}
}
}连接到本地 InfluxDB 服务器
{
"mcpServers": {
"influxdb": {
"command": "docker",
"args": [
"run",
"--rm",
"--interactive",
"--add-host=host.docker.internal:host-gateway"
"--env",
"INFLUX_DB_PRODUCT_TYPE",
"--env",
"INFLUX_DB_INSTANCE_URL",
"--env",
"INFLUX_DB_TOKEN",
"influxdata/influxdb3-mcp-server"
],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "core",
"INFLUX_DB_INSTANCE_URL": "http://host.docker.internal:8181",
"INFLUX_DB_TOKEN": "AUTH_TOKEN"
}
}
}
}支持的功能
连接后，您可以使用 LLM 代理在 InfluxDB 3 Core 服务器上执行任务，包括：
- 创建、更新和删除数据库
- 列出表并检查架构
- 创建和管理令牌
- 在不编写 SQL 或 InfluxQL 的情况下查询数据
- 检查服务器运行状况和连接状态
支持的提示示例
“列出
production数据库中的所有表。”“为
metrics数据库创建一个只读令牌。”“分析上周的传感器数据以查找异常。”
“创建一个名为
iot_sensors的新数据库，保留期为 30 天。”“显示
sensor_data表的架构。”
此页面是否有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一员！我们欢迎并鼓励您对 InfluxDB 3 Core 和本文档提供反馈和错误报告。要获得支持，请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。