InfluxDB MCP Server

InfluxDB MCP 服务器

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

特征

该 MCP 服务器提供：

• 资源：访问组织、存储桶和测量数据
• 工具：写入数据、执行查询和管理数据库对象
• 提示：常见 Flux 查询和线路协议格式的模板

资源

服务器公开以下资源：

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 服务器功能

运行测试：

执照

麻省理工学院