InfluxDB MCP 服务器

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

概述

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

前提条件

• Docker
• InfluxDB 1.8 实例（已运行）
• InfluxDB 实例的凭据

安装

1. 克隆存储库:

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

2. 创建一个 .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
   

3. 构建并运行 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

# 创建一个令牌
payload = {
    "sub": "username",  # 替换为您要标识的用户名
    "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 客户端一起使用

1. 使用 JWT 令牌验证 MCP 服务器：

   Tool: auth
   Arguments: {"token": "your.jwt.token.here"}
   

2. 查询您的 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"
   }
   

故障排除

如果您遇到问题：

1. 与 InfluxDB 的连接错误:

   • 验证 INFLUXDB_HOST 是否正确，并且可以从 Docker 容器访问
   • 检查您的 InfluxDB 凭据是否正确
   • 确保您的 InfluxDB 实例已配置为接受来自外部主机的连接

2. 身份验证问题:

   • 验证您的 JWT_SECRET 是否设置正确
   • 确保您使用的令牌与 JWT_SECRET 匹配且未过期
   • 检查您的 InfluxDB 凭据是否具有对数据库的读取权限

3. 检查日志:

   docker logs
   

安全注意事项

• MCP 服务器仅允许对您的 InfluxDB 实例进行只读访问
• 所有查询都经过验证，以确保它们以 SELECT 开头
• JWT 身份验证保护对 MCP 服务器的访问
• 考虑在专用网络中运行服务器以获得额外的安全性

感谢您与我合作。 如果您对代码有任何疑问，或者想要构建更多内容，请联系我：m4tyn0@gmail.com