InfluxDB MCP 服务器

一个模型上下文协议 (MCP) 服务器，使用 InfluxDB OSS API v2 公开对 InfluxDB 实例的访问。主要使用 Claude 代码构建。

特征

该 MCP 服务器提供：

• 资源：访问组织、存储桶和测量数据

• 工具：写入数据、执行查询和管理数据库对象

• 提示：常见 Flux 查询和线路协议格式的模板

Related MCP server: MCP Deep Web Research Server

资源

服务器公开以下资源：

1. 组织列表： influxdb://orgs

   • 显示 InfluxDB 实例中的所有组织

2. 存储桶列表： influxdb://buckets

   • 显示所有存储桶及其元数据

3. 存储桶测量： influxdb://bucket/{bucketName}/measurements

   • 列出指定存储桶内的所有测量值

4. 查询数据： influxdb://query/{orgName}/{fluxQuery}

   • 执行 Flux 查询并将结果作为资源返回

工具

服务器提供以下工具：

1. write-data ：以线路协议格式写入时间序列数据

   • 参数：org、bucket、data、precision（可选）

2. query-data ：执行 Flux 查询

   • 参数：org，query

3. create-bucket ：创建一个新的存储桶

   • 参数：name、orgID、retentionPeriodSeconds（可选）

4. create-org ：创建新组织

   • 参数：名称、描述（可选）

提示

服务器提供以下提示模板：

1. flux-query-examples ：常见的 Flux 查询示例

2. line-protocol-guide ：InfluxDB 线路协议格式指南

配置

服务器需要以下环境变量：

• INFLUXDB_TOKEN （必需）：InfluxDB API 的身份验证令牌

• INFLUXDB_URL (可选): InfluxDB 实例的 URL (默认为http://localhost:8086 )

• INFLUXDB_ORG （可选）：某些操作的默认组织名称

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 InfluxDB MCP 服务器：

选项 1：使用 npx 运行（推荐）

选项 2：全局安装

选项 3：从源头

与 Claude for Desktop 集成

将服务器添加到您的claude_desktop_config.json ：

使用 npx（推荐）

如果本地安装

代码结构

服务器代码被组织成模块化结构：

• src/

  • index.js - 主服务器入口点

  • config/ ——配置相关文件

    • env.js - 环境变量处理

  • utils/ ——实用函数

    • influxClient.js - InfluxDB API 客户端

    • loggerConfig.js - 控制台记录器配置

  • handlers/ - 资源和工具处理程序

    • organizationsHandler.js - 组织列表

    • bucketsHandler.js - 存储桶列表

    • measurementsHandler.js - 测量列表

    • queryHandler.js - 查询执行

    • writeDataTool.js - 数据写入工具

    • queryDataTool.js - 查询工具

    • createBucketTool.js - Bucket创建工具

    • createOrgTool.js - 组织创建工具

  • prompts/ -提示模板

    • fluxQueryExamplesPrompt.js - Flux 查询示例

    • lineProtocolGuidePrompt.js - 线路协议指南

这种结构可以实现更好的可维护性、更容易的测试和更清晰的关注点分离。

测试

该存储库包括全面的集成测试：

• 使用 InfluxDB 启动 Docker 容器

• 使用示例数据填充

• 测试所有 MCP 服务器功能

运行测试：

执照

麻省理工学院