InfluxDB查询服务

mcflux是一个为InfluxDB v1提供的只读MCP服务器,允许通过模型上下文协议查询和探索时间序列数据。

  • by dmayan-ss
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dmayan-ss/mcpflux

使用说明

mcflux

只读MCP服务器 InfluxDB v1。让Claude(桌面或代码)通过模型上下文协议查询和探索您的时间序列数据。

工具

工具 说明
ping 检查连接并返回InfluxDB版本
list_databases 列出所有数据库
list_measurements 在数据库中列出测量值
list_tag_keys 列出标签键,可选择按测量值过滤
list_field_keys 列出字段键及其类型
list_tag_values 列出特定标记键的值
query 执行只读InfluxQL查询(仅限SELECT/SHOW)

写入操作(CREATE, DROP, DELETE, INSERT等等)在服务器级别被阻止。

需求

  • Python 3.10+
  • 紫外线 包管理器
  • InfluxDB v1实例

安装

克劳德桌面(扩展)

下载最新 .mcpb 从 发布那么:

  1. 打开克劳德桌面
  2. 首选 设置>扩展>高级设置
  3. 点击 安装扩展 并选择 .mcpb 文件
  4. 在配置表单中填写您的InfluxDB URL、用户名和密码

克劳德桌面(手动)

添加 claude_desktop_config.json:

  • 视窗: %AppData%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "influxdb": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcflux", "run", "server.py"],
      "env": {
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_USERNAME": "myuser",
        "INFLUXDB_PASSWORD": "mypass"
      }
    }
  }
}

克劳德代码

添加 .claude/settings.json 或您的项目设置:

{
  "mcpServers": {
    "influxdb": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcflux", "run", "server.py"],
      "env": {
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_USERNAME": "myuser",
        "INFLUXDB_PASSWORD": "mypass"
      }
    }
  }
}

配置

环境变量 必填 默认 说明
INFLUXDB_URL 没有 http://localhost:8086 InfluxDB HTTP API URL
INFLUXDB_USERNAME 没有 (无) 基本身份验证的用户名
INFLUXDB_PASSWORD 没有 (无) 基本身份验证密码

省略 INFLUXDB_USERNAME 和 INFLUXDB_PASSWORD 如果您的实例不需要身份验证。

构建.mcpb包

npm install -g @anthropic-ai/mcpb
mcpb pack .

这产生了一个 mcflux.mcpb 可以作为Claude Desktop扩展安装的文件。

许可证

麻省理工学院