InfluxDB MCP 服务器

Name: InfluxDB MCP Server
Author: m4tyn0

模型上下文协议 (MCP) 服务器通过 JWT 身份验证提供对 InfluxDB 1.8 的安全只读访问。

概述

InfluxDB MCP 服务器允许 AI 助手通过标准化接口查询存储在 InfluxDB 中的时间序列数据。它通过 JWT 令牌进行身份验证，提供对 InfluxDB 实例的只读访问权限。

Related MCP server: MongoDB MCP Server

先决条件

Docker
InfluxDB 1.8 实例（已运行）
您的 InfluxDB 实例的凭证

安装

克隆存储库：

git clone https://github.com/m4tyn0/influx_mcp
cd influxdb-mcp-server

使用您的配置创建一个.env文件：

cp env.example .env

INFLUXDB_HOST=
INFLUXDB_PORT=8086
INFLUXDB_USERNAME=
INFLUXDB_PASSWORD=
INFLUXDB_SSL=false
INFLUXDB_VERIFY_SSL=true
INFLUXDB_TIMEOUT=10
JWT_SECRET=
JWT_ALGORITHM=HS256

构建并运行 Docker 容器：

docker build -t influxdb-mcp-server .
docker run -d --env-file .env -p 8000:8000 influxdb-mcp-server

JWT 身份验证

服务器使用 JWT 令牌进行身份验证。您需要生成一个令牌来与 MCP 服务器进行身份验证，以下是一个简单的脚本：

import jwt
import datetime

# Create a token
payload = {
    "sub": "username",  # Replace with the username you want to identify with
    "iat": datetime.datetime.utcnow(),
    "exp": datetime.datetime.utcnow() + datetime.timedelta(hours=1)
}
token = jwt.encode(payload, "your-jwt-secret", algorithm="HS256")
print(token)

保存此令牌以供您的 MCP 客户端使用。

与 MCP 客户端一起使用

使用 JWT 令牌向 MCP 服务器进行身份验证：
```
Tool: auth
Arguments: {"token": "your.jwt.token.here"}
```

查询您的 InfluxDB 数据：

Tool: list_databases
Arguments: {}

Tool: list_measurements
Arguments: {"database": "your_database_name"}

Tool: query
Arguments: {
  "database": "your_database_name",
  "query": "SELECT * FROM measurement_name LIMIT 10"
}

故障排除

如果您遇到问题：

与 InfluxDB 的连接错误：
- 验证 INFLUXDB_HOST 是否正确并且可以从 Docker 容器访问
- 检查您的 InfluxDB 凭据是否正确
- 确保您的 InfluxDB 实例配置为接受来自外部主机的连接
身份验证问题：
- 验证您的 JWT_SECRET 设置是否正确
- 确保您使用的令牌与 JWT_SECRET 匹配并且未过期
- 检查您的 InfluxDB 凭据是否具有对数据库的读取权限
检查日志：
```
docker logs 
```