Servidor MCP de InfluxDB
Un servidor de Protocolo de contexto de modelo (MCP) que proporciona acceso seguro y de solo lectura a InfluxDB 1.8 a través de la autenticación JWT.
Descripción general
El servidor MCP de InfluxDB permite a los asistentes de IA consultar datos de series temporales almacenados en InfluxDB mediante una interfaz estandarizada. Proporciona acceso de solo lectura a su instancia de InfluxDB con autenticación mediante tokens JWT.
Prerrequisitos
- Estibador
- Instancia de InfluxDB 1.8 (ya en ejecución)
- Credenciales para su instancia de InfluxDB
Instalación
- Clonar el repositorio :
git clone https://github.com/m4tyn0/influx_mcp
cd influxdb-mcp-server
- Crea un archivo
.env con tu configuración:INFLUXDB_HOST=
INFLUXDB_PORT=8086
INFLUXDB_USERNAME=
INFLUXDB_PASSWORD=
INFLUXDB_SSL=false
INFLUXDB_VERIFY_SSL=true
INFLUXDB_TIMEOUT=10
JWT_SECRET=
JWT_ALGORITHM=HS256
- Construya y ejecute el contenedor Docker :
docker build -t influxdb-mcp-server .
docker run -d --env-file .env -p 8000:8000 influxdb-mcp-server
Autenticación JWT
El servidor utiliza tokens JWT para la autenticación. Necesita generar un token para autenticarse con el servidor MCP. Aquí tiene un script sencillo para hacerlo:
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)
Guarde este token para usarlo con su cliente MCP.
Uso con clientes MCP
- Autenticarse con el servidor MCP usando el token JWT:
Tool: auth
Arguments: {"token": "your.jwt.token.here"}
- Consulta tus datos de 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"
}
Solución de problemas
Si encuentra problemas:
- Errores de conexión a InfluxDB :
- Verifique que INFLUXDB_HOST sea correcto y accesible desde el contenedor Docker
- Verifique que sus credenciales de InfluxDB sean correctas
- Asegúrese de que su instancia de InfluxDB esté configurada para aceptar conexiones de hosts externos
- Problemas de autenticación :
- Verifique que su JWT_SECRET esté configurado correctamente
- Asegúrese de que el token que está utilizando coincida con JWT_SECRET y no haya expirado
- Verifique que sus credenciales de InfluxDB tengan acceso de lectura a las bases de datos
- Comprobar registros :
Notas de seguridad
- El servidor MCP solo permite acceso de solo lectura a su instancia de InfluxDB
- Todas las consultas se validan para garantizar que comiencen con SELECT
- La autenticación JWT protege el acceso al servidor MCP
- Considere ejecutar el servidor en una red privada para mayor seguridad