Redash MCP Server

Servidor MCP de Redash

Servidor de Protocolo de Contexto de Modelo (MCP) para integrar Redash con asistentes de IA como Claude.

Características

• Conéctese a instancias de Redash a través de la API de Redash
• Enumere las consultas y los paneles disponibles como recursos
• Ejecutar consultas y recuperar resultados
• Crear y gestionar consultas (crear, actualizar, archivar)
• Lista de fuentes de datos para la creación de consultas
• Obtenga detalles y visualizaciones del panel

Prerrequisitos

• Node.js (v18 o posterior)
• npm o hilo
• Acceso a una instancia de Redash
• Clave API de Redash

Variables de entorno

El servidor requiere las siguientes variables de entorno:

• REDASH_URL : la URL de su instancia de Redash (por ejemplo, https://redash.example.com )
• REDASH_API_KEY : Su clave API de Redash

Variables opcionales:

• REDASH_TIMEOUT : Tiempo de espera para solicitudes de API en milisegundos (valor predeterminado: 30000)
• REDASH_MAX_RESULTS : Número máximo de resultados a devolver (predeterminado: 1000)

Instalación

1. Clonar este repositorio:
   git clone https://github.com/suthio/redash-mcp.git cd redash-mcp
2. Instalar dependencias:
   npm install
3. Cree un archivo .env con su configuración de Redash:
   REDASH_URL=https://your-redash-instance.com REDASH_API_KEY=your_api_key
4. Construir el proyecto:
   npm run build
5. Iniciar el servidor:
   npm start

Uso con Claude para escritorio

Para utilizar este servidor MCP con Claude for Desktop, configúrelo en su archivo de configuración de Claude for Desktop:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

Agregue la siguiente configuración (edite las rutas según sea necesario):

Herramientas disponibles

Gestión de consultas

• list-queries : enumera todas las consultas disponibles en Redash
• get-query : Obtener detalles de una consulta específica
• create-query : Crea una nueva consulta en Redash
• update-query : Actualizar una consulta existente en Redash
• archive-query : Archivar (eliminar temporalmente) una consulta
• list-data-sources : enumera todas las fuentes de datos disponibles

Ejecución de consultas

• execute-query : ejecuta una consulta y devuelve resultados

Gestión del panel de control

• list-dashboards : enumera todos los paneles disponibles
• get-dashboard : Obtener detalles y visualizaciones del panel
• get-visualization : Obtener detalles de una visualización específica

Desarrollo

Ejecutar en modo de desarrollo:

Historial de versiones

• v1.1.0: Se agregó funcionalidad de gestión de consultas (crear, actualizar, archivar)
• v1.0.0: Versión inicial

Licencia

Instituto Tecnológico de Massachusetts (MIT)