InfluxDB MCP 서버
JWT 인증을 통해 InfluxDB 1.8에 대한 안전하고 읽기 전용 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다.
개요
InfluxDB MCP 서버를 사용하면 AI 어시스턴트가 표준화된 인터페이스를 통해 InfluxDB에 저장된 시계열 데이터를 쿼리할 수 있습니다. JWT 토큰을 통한 인증을 통해 InfluxDB 인스턴스에 대한 읽기 전용 액세스를 제공합니다.
필수 조건
- 도커
- InfluxDB 1.8 인스턴스(이미 실행 중)
- InfluxDB 인스턴스에 대한 자격 증명
설치
- 저장소를 복제합니다 .지엑스피1
- 구성으로
.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에 대한 연결 오류 :
- Docker 컨테이너에서 INFLUXDB_HOST가 올바르고 액세스 가능한지 확인하세요.
- InfluxDB 자격 증명이 올바른지 확인하세요
- InfluxDB 인스턴스가 외부 호스트의 연결을 허용하도록 구성되어 있는지 확인하세요.
- 인증 문제 :
- JWT_SECRET이 올바르게 설정되었는지 확인하세요.
- 사용 중인 토큰이 JWT_SECRET과 일치하고 만료되지 않았는지 확인하세요.
- InfluxDB 자격 증명에 데이터베이스에 대한 읽기 액세스 권한이 있는지 확인하세요.
- 로그 확인 :
보안 참고 사항
- MCP 서버는 InfluxDB 인스턴스에 대한 읽기 전용 액세스만 허용합니다.
- 모든 쿼리는 SELECT로 시작하는지 확인하기 위해 검증됩니다.
- JWT 인증은 MCP 서버에 대한 액세스를 보호합니다.
- 추가 보안을 위해 개인 네트워크에서 서버를 실행하는 것을 고려하세요.