Agregar servidor MCP Metabase
Some checks failed
build-and-deploy / build-and-deploy (push) Failing after 9s

- Implementado mcp-metabase-server con TypeScript
- 9 herramientas para interactuar con Metabase API
- Soporta listar/buscar cards, ejecutar queries con parámetros
- Soporta crear y actualizar cards
- Autenticación con API Key
- Agregado servicio al docker-compose.yml
- Configurado en Traefik sin autenticación Authentik
- Actualizado README con documentación completa
- Variables y secrets configurados en Gitea
This commit is contained in:
2025-10-28 10:49:18 -06:00
parent b57ac8de83
commit 5c6fd8fef3
9 changed files with 658 additions and 0 deletions

View File

@@ -21,12 +21,18 @@ claude mcp add --transport http nucleodocs-gitea https://gitea.nucleoriofrio.com
claude mcp add chrome-devtools npx -- chrome-devtools-mcp@latest --isolated=true
```
### MCP Metabase Server
```bash
claude mcp add --transport http nucleodocs-metabase https://metabase.nucleoriofrio.com/mcp
```
### Scopes Disponibles
**Para compartir con el equipo** (crea .mcp.json en el proyecto):
```bash
claude mcp add --transport http nucleodocs-docker --scope project https://docker.nucleoriofrio.com/mcp
claude mcp add --transport http nucleodocs-gitea --scope project https://gitea.nucleoriofrio.com/mcp
claude mcp add --transport http nucleodocs-metabase --scope project https://metabase.nucleoriofrio.com/mcp
claude mcp add chrome-devtools --scope project npx -- chrome-devtools-mcp@latest --isolated=true
```
@@ -34,6 +40,7 @@ claude mcp add chrome-devtools --scope project npx -- chrome-devtools-mcp@latest
```bash
claude mcp add --transport http nucleodocs-docker --scope user https://docker.nucleoriofrio.com/mcp
claude mcp add --transport http nucleodocs-gitea --scope user https://gitea.nucleoriofrio.com/mcp
claude mcp add --transport http nucleodocs-metabase --scope user https://metabase.nucleoriofrio.com/mcp
claude mcp add chrome-devtools --scope user npx -- chrome-devtools-mcp@latest --isolated=true
```
@@ -45,6 +52,7 @@ claude mcp list
# Ver detalles de un servidor específico
claude mcp get nucleodocs-docker
claude mcp get nucleodocs-gitea
claude mcp get nucleodocs-metabase
claude mcp get chrome-devtools
# Dentro de Claude Code, verificar el estado
@@ -78,6 +86,7 @@ Este repositorio contiene la documentación del funcionamiento del sistema Nucle
- ✅ Claude Code hooks para monitoreo de Actions
- ✅ MCP Server Docker para gestión de contenedores
- ✅ MCP Server Gitea para API de Gitea
- ✅ MCP Server Metabase para análisis y reportes
- ✅ MCP Server Chrome DevTools para testing e interacción con navegador
## Servicios
@@ -115,6 +124,28 @@ Servidor MCP personalizado construido con TypeScript que expone la API de Gitea
- `POST /mcp` - Protocolo MCP para operaciones Gitea
- `GET /health` - Health check del servicio
### MCP Metabase Server (`mcp-metabase`)
Servidor MCP personalizado construido con TypeScript que expone la API de Metabase a través del protocolo MCP sobre HTTP. Este servicio:
- Implementa 9 herramientas para interactuar con Metabase
- Usa el puerto 3000 para comunicación HTTP
- Se conecta a Metabase mediante URL interna y autenticación con API Key
- Se ejecuta en las redes `principal` y `traefik-network`
- **Expuesto públicamente en `metabase.nucleoriofrio.com/mcp` SIN autenticación Authentik**
- Prioridad 200 en Traefik para evitar conflictos con otros routers
- Herramientas disponibles:
- `metabase_cards` - Listar y buscar cards/questions
- `metabase_card_info` - Obtener detalles de una card
- `metabase_execute_card` - Ejecutar cards con parámetros
- `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
- `metabase_dashboards` - Listar dashboards
- `metabase_dashboard_info` - Obtener detalles de un dashboard
- Endpoints disponibles:
- `POST /mcp` - Protocolo MCP para operaciones Metabase
- `GET /health` - Health check del servicio
## Ejemplos de Uso
Una vez agregados los servidores MCP, podrás usar las herramientas directamente en Claude Code:
@@ -133,6 +164,14 @@ Una vez agregados los servidores MCP, podrás usar las herramientas directamente
> Busca issues abiertos en el repositorio analiticaNucleo
```
**Para Metabase:**
```
> Lista todas las cards de Metabase
> Busca cards que contengan "ventas" en el nombre
> Ejecuta la card 123 con parámetros de fecha
> Crea una nueva card con una query SQL
```
**Para Chrome DevTools:**
```
> Abre https://docs.nucleoriofrio.com y toma un snapshot