Agregar servidor MCP Metabase
Some checks failed
build-and-deploy / build-and-deploy (push) Failing after 9s
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:
39
README.md
39
README.md
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user