InfluxDB MCP Server

InfluxDB MCP Server

site icon
2025.03.12 5
JavaScript时间序列数据库数据管理数据库
InfluxDB MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,通过 InfluxDB OSS API v2 提供对 InfluxDB 实例的访问。它主要用于管理和操作时间序列数据,包括组织、桶(bucket)和测量数据(measurement data)的访问,以及数据的写入、查询和数据库对象的管理。
View on GitHub

Overview

基本能力

产品定位

InfluxDB MCP Server 是一个专门用于管理和操作 InfluxDB 时间序列数据的服务,通过 MCP 协议提供对 InfluxDB 实例的访问。

核心功能

  • 资源访问:提供对组织、桶和测量数据的访问。
  • 工具支持:包括数据写入、查询执行、桶和组织创建等功能。
  • 提示模板:提供常见的 Flux 查询示例和行协议格式指南。

适用场景

  • 时间序列数据的管理和操作。
  • 需要频繁查询和写入 InfluxDB 数据的应用场景。
  • 开发人员需要快速访问和管理 InfluxDB 实例的场景。

工具列表

  1. write-data:以行协议格式写入时间序列数据。
  2. query-data:执行 Flux 查询。
  3. create-bucket:创建新桶。
  4. create-org:创建新组织。

常见问题解答

  • 如何配置环境变量?:需要设置 INFLUXDB_TOKEN 作为认证令牌,可选设置 INFLUXDB_URLINFLUXDB_ORG
  • 如何运行测试?:使用 npm test 命令运行集成测试。

使用教程

使用依赖

  • 需要安装 Node.js 和 npm。

安装教程

选项1:使用 npx 运行(推荐)

INFLUXDB_TOKEN=your_token npx influxdb-mcp-server

选项2:全局安装

npm install -g influxdb-mcp-server
INFLUXDB_TOKEN=your_token influxdb-mcp-server

选项3:从源代码安装

git clone https://github.com/idoru/influxdb-mcp-server.git
cd influxdb-mcp-server
npm install
INFLUXDB_TOKEN=your_token npm start

调试方式

  • 运行 npm test 进行集成测试。
  • 检查环境变量是否正确设置。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。