InfluxDB MCP 服务器

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

功能

此 MCP 服务器提供：

• 资源: 访问组织、存储桶和测量数据
• 工具: 写入数据、执行查询和管理数据库对象
• 提示: 常用 Flux 查询和 Line Protocol 格式的模板

资源

服务器公开以下资源：

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

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

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

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

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

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

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

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

工具

服务器提供以下工具：

1. write-data: 以 line protocol 格式写入时间序列数据

   • 参数: org, bucket, data, precision (可选)

2. query-data: 执行 Flux 查询

   • 参数: org, query

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

   • 参数: name, orgID, retentionPeriodSeconds (可选)

4. create-org: 创建一个新的组织

   • 参数: name, description (可选)

提示

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

1. flux-query-examples: 常用 Flux 查询示例
2. line-protocol-guide: InfluxDB line protocol 格式指南

配置

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

• INFLUXDB_TOKEN (必需): InfluxDB API 的身份验证令牌
• INFLUXDB_URL (可选): InfluxDB 实例的 URL (默认为 http://localhost:8086)
• INFLUXDB_ORG (可选): 用于某些操作的默认组织名称

安装

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

# 直接使用 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

与 Claude for Desktop 集成

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

使用 npx (推荐)

{
  "mcpServers": {
    "influxdb": {
      "command": "npx",
      "args": ["influxdb-mcp-server"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

如果本地安装

{
  "mcpServers": {
    "influxdb": {
      "command": "node",
      "args": ["/path/to/influxdb-mcp-server/src/index.js"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

代码结构

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

• 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 - 存储桶创建工具
    • createOrgTool.js - 组织创建工具
  • prompts/ - 提示模板
    • fluxQueryExamplesPrompt.js - Flux 查询示例
    • lineProtocolGuidePrompt.js - Line protocol 指南

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

测试

该存储库包含全面的集成测试，这些测试：

• 启动一个带有 InfluxDB 的 Docker 容器
• 使用示例数据填充它
• 测试所有 MCP 服务器功能

要运行测试：

npm test

许可证

MIT