使用说明
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 从 发布那么:
- 打开克劳德桌面
- 首选 设置>扩展>高级设置
- 点击 安装扩展 并选择
.mcpb文件 - 在配置表单中填写您的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扩展安装的文件。