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

Related MCP server: Crunchbase MCP Server

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):

{
  "mcpServers": {
    "redash": {
      "command": "npx",
      "args": [
         "-y",
         "@suthio/redash-mcp"
      ],
      "env": {
        "REDASH_API_KEY": "your-api-key",
        "REDASH_URL": "https://your-redash-instance.com"
      }
    }
  }
}

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:

npm run dev

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)