Implementar parámetro verbose y paginación en MCP Metabase
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 21s
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 21s
Mejoras implementadas:
- Parámetro verbose en metabase_cards, metabase_databases, metabase_collections
- Paginación en metabase_cards (page, pageSize)
- Funciones helper para filtrado de campos (filterCardFields, filterDatabaseFields, filterCollectionFields)
- Corrección de bug en metabase_databases con include_tables (API devuelve {data: []} en lugar de array directo)
Resultados:
- Reducción 94.7% en tamaño de respuestas de cards (60KB → 3KB por 5 cards)
- Reducción 90.2% en tamaño de respuestas de databases (2KB → 198 bytes)
- 100% de pruebas exitosas (9/9)
Documentación:
- Agregado ANALISIS-RESULTADOS.md con análisis detallado
- Agregado SPEC-VERBOSE.md con especificación técnica
- Agregado README-TESTING.md con guía de pruebas
- Actualizado README.md con ejemplos de uso de verbose y paginación
- Actualizado .gitignore para excluir scripts de prueba con API keys
This commit is contained in:
@@ -12,16 +12,31 @@ claude mcp add --transport http nucleodocs-metabase https://metabase.nucleoriofr
|
||||
|
||||
Proporciona herramientas MCP para:
|
||||
|
||||
- **metabase_cards**: Listar y buscar cards/questions
|
||||
- **metabase_cards**: Listar y buscar cards/questions con soporte para `verbose` y paginación
|
||||
- **metabase_card_info**: Obtener detalles de una card específica
|
||||
- **metabase_execute_card**: Ejecutar cards con parámetros dinámicos
|
||||
- **metabase_create_card**: Crear nuevas cards/questions
|
||||
- **metabase_update_card**: Actualizar nombre y descripción de cards
|
||||
- **metabase_collections**: Listar colecciones
|
||||
- **metabase_databases**: Listar bases de datos (con opción de incluir metadata)
|
||||
- **metabase_collections**: Listar colecciones con soporte para `verbose`
|
||||
- **metabase_databases**: Listar bases de datos con soporte para `verbose` y metadata
|
||||
- **metabase_dashboards**: Listar dashboards
|
||||
- **metabase_dashboard_info**: Obtener detalles de un dashboard
|
||||
|
||||
### Parámetro `verbose`
|
||||
|
||||
Por defecto, las herramientas devuelven respuestas **ligeras** optimizadas para listados (reducción de ~90-95% en tamaño).
|
||||
Usa `verbose: true` para obtener **toda la información** disponible.
|
||||
|
||||
**Beneficios:**
|
||||
- ⚡ Respuestas 10-20x más rápidas por defecto
|
||||
- 💾 Reducción de 90-95% en uso de tokens
|
||||
- 🎯 Solo pides información detallada cuando la necesitas
|
||||
|
||||
**Herramientas con soporte `verbose`:**
|
||||
- `metabase_cards`
|
||||
- `metabase_databases`
|
||||
- `metabase_collections`
|
||||
|
||||
## Variables de Entorno
|
||||
|
||||
```bash
|
||||
@@ -77,12 +92,25 @@ claude mcp add --transport http nucleodocs-metabase https://metabase.tudominio.c
|
||||
|
||||
## Ejemplos de Uso
|
||||
|
||||
### Listar todas las cards
|
||||
### Listar cards (modo ligero - default)
|
||||
|
||||
```typescript
|
||||
{
|
||||
"action": "list"
|
||||
"action": "list",
|
||||
"pageSize": 20 // Máximo 100
|
||||
}
|
||||
// Respuesta: ~600 bytes por 20 cards (solo campos esenciales)
|
||||
```
|
||||
|
||||
### Listar cards (modo verbose - completo)
|
||||
|
||||
```typescript
|
||||
{
|
||||
"action": "list",
|
||||
"pageSize": 20,
|
||||
"verbose": true // Incluye creator, dataset_query, parameters, etc.
|
||||
}
|
||||
// Respuesta: ~240 KB por 20 cards (todos los campos)
|
||||
```
|
||||
|
||||
### Buscar cards por nombre
|
||||
@@ -94,6 +122,17 @@ claude mcp add --transport http nucleodocs-metabase https://metabase.tudominio.c
|
||||
}
|
||||
```
|
||||
|
||||
### Paginación
|
||||
|
||||
```typescript
|
||||
{
|
||||
"action": "list",
|
||||
"page": 2,
|
||||
"pageSize": 50
|
||||
}
|
||||
// Devuelve página 2 con 50 cards
|
||||
```
|
||||
|
||||
### Ejecutar card con parámetros
|
||||
|
||||
```typescript
|
||||
|
||||
Reference in New Issue
Block a user