🚀 InfluxDB MCP 服务器

InfluxDB MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它借助 InfluxDB OSS API v2，为用户提供对 InfluxDB 实例的便捷访问。该项目主要使用 Claude Code 构建。

🚀 快速开始

要使用 InfluxDB MCP 服务器，你需要先进行配置和安装。配置时，请添加以下环境变量：

INFLUXDB_URL=http://localhost:8086
INFLUXDB_TOKEN=your-influxdb-token

安装方式有多种，你可以根据自己的需求选择：

使用 npx 安装

npx influx-mcp-server@latest --install

全局安装

npm install -g influx-mcp-server

从源码安装

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 安装依赖项：

   npm install
   

3. 启动服务器：

   npm start
   

✨ 主要特性

此 MCP 服务器具备丰富的功能，主要包括以下几个方面：

• 资源：可对组织、存储桶和测量数据进行访问。
• 工具：支持写入数据、执行查询以及管理数据库对象等操作。
• 提示模板：提供常见 Flux 查询示例和 Line Protocol 格式指南。

📦 安装指南

使用 npx 安装

npx influx-mcp-server@latest --install

全局安装

npm install -g influx-mcp-server

从源码安装

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 安装依赖项：

   npm install
   

3. 启动服务器：

   npm start
   

📚 详细文档

资源

该服务器暴露了以下资源：

1. 组织列表：influxdb://orgs
   • 显示 InfluxDB 实例中的所有组织
2. 存储桶列表：influxdb://buckets
   • 展示所有存储桶及其元数据
3. 存储桶测量值：influxdb://bucket/{bucketName}/measurements
   • 列出指定存储桶内的所有测量值
4. 查询数据：influxdb://query/{orgName}/{fluxQuery}
   • 执行 Flux 查询并返回结果作为资源

工具

服务器提供了以下实用工具：

1. write-data：按行协议格式写入时序数据
   • 参数：组织、存储桶、数据、精度（可选）
2. query-data：执行 Flux 查询
   • 参数：组织、查询
3. create-bucket：创建新存储桶
   • 参数：名称、组织、元数据（可选）
4. create-org：创建新组织
   • 参数：组织名称

提示模板

1. Flux 查询示例提示：提供常见 Flux 查询的示例和指南
2. Line Protocol 格式指南：解释如何使用 Line Protocol 格式写入数据

配置

要配置 InfluxDB MCP 服务器，请添加以下环境变量：

INFLUXDB_URL=http://localhost:8086
INFLUXDB_TOKEN=your-influxdb-token

🔧 技术细节

代码结构

src/
├── main.ts                 # 主程序入口
├── config.ts              # 配置文件
└── modules/
    ├── influxdb/          # InfluxDB 相关模块
    │   └── connection.ts  # 连接管理
    ├── prompts/           # 提示模板
    │   ├── flux-query-examples.prompt.ts      # Flux 查询示例提示
    │   └── line-protocol-guide.prompt.ts     # Line Protocol 指南
    └── utils/             # 工具函数
        └── logger.ts       # 日志记录工具

测试

仓库包含全面的集成测试，具体流程如下：

• 启动 Docker 容器中的 InfluxDB 实例
• 填充示例数据
• 测试所有 MCP 服务器功能

运行测试的命令如下：

npm test

📄 许可证

本项目采用 MIT 许可证。