dtic-DIIAA/docs/mcps/MSPs-Antigravity.md

# MSPs en Antigravity - Guía de Referencia

## ¿Qué son los MSPs?

Los **MSP (Markdown Style Papers)** son documentos generados por NotebookLM en formato de paper académico con:
- Título y autores
- Resumen estructurado
- Secciones temáticas
- Citas y referencias
- Formato académico profesional

## MCPs Actualmente Configurados en Antigravity

Archivo de configuración: `~/.gemini/antigravity/mcp_config.json`

### 1. NotebookLM MCP

```json
"notebooklm": {
  "command": "bash",
  "args": ["-c", "/home/rmonla/.local/share/notebooklm-mcp/bin/notebooklm-mcp"],
  "env": {},
  "disabled": false
}
```

| Campo | Valor |
|-------|-------|
| Tipo | MCP Server (stdio) |
| Ejecutable | `/home/rmonla/.local/share/notebooklm-mcp/bin/notebooklm-mcp` |
| Estado | Habilitado |
| Soporta MSP | **No** (solo desde UI web) |

### 2. Firebase MCP Server

```json
"firebase-mcp-server": {
  "command": "npx",
  "args": ["-y", "firebase-tools@latest", "mcp"],
  "env": {},
  "disabled": false
}
```

| Campo | Valor |
|-------|-------|
| Tipo | MCP Server (npx) |
| Paquete | `firebase-tools@latest` |
| Estado | Habilitado |
| Herramientas | Auto-detección basada en firebase.json |

**Herramientas disponibles** (según contexto del proyecto):
- Core: deploy, init, login, logout, projects:list
- Firestore: firestore:indexes, firestore:rules
- Hosting: hosting:deploy
- Functions: functions:deploy
- Storage: storage:rules

### 3. Google Stitch MCP

```json
"stitch": {
  "serverUrl": "https://stitch.googleapis.com/mcp",
  "headers": {
    "X-Goog-Api-Key": "AQ.Ab8RN6KSXqPMkt6b6-l9-fOF_L6MFDobit1k2uCZark0orUM0g"
  }
}
```

| Campo | Valor |
|-------|-------|
| Tipo | HTTP MCP Server |
| URL | `https://stitch.googleapis.com/mcp` |
| Estado | Habilitado |
| API Key | Configurada |

### Verificar MCPs configurados

```bash
# Ver configuración actual
cat ~/.gemini/antigravity/mcp_config.json | jq '.mcpServers | keys'

# Probar cada MCP
~/.local/share/notebooklm-mcp/bin/notebooklm-mcp --transport http --port 8765
npx -y firebase-tools@latest mcp --help
```

## Configuración de NotebookLM MCP

### Verificar conexión

```bash
# 1. Verificar ejecutable
ls -la ~/.local/share/notebooklm-mcp/bin/notebooklm-mcp

# 2. Probar inicio del servidor
~/.local/share/notebooklm-mcp/bin/notebooklm-mcp --transport http --port 8765

# 3. Verificar en Antigravity
# Abrir "Manage MCP servers" → buscar "notebooklm" → estado "conectado"
```

### Autenticación

```bash
# Ejecutar autenticación via navegador
notebooklm-mcp-auth

# O configurar manualmente con variables de entorno
export NOTEBOOKLM_COOKIES="..."
export NOTEBOOKLM_CSRF_TOKEN="..."
export NOTEBOOKLM_SESSION_ID="..."
```

### Ubicaciones importantes

| Recurso | Ruta |
|---------|------|
| Executable | `~/.local/share/notebooklm-mcp/bin/notebooklm-mcp` |
| Auth cache | `~/.notebooklm-mcp/auth.json` |
| Logs | `~/.config/Antigravity/logs/` |
| Config MCP | `~/.gemini/antigravity/mcp_config.json` |

## Herramientas MCP Disponibles (32 herramientas)

### Notebooks
- `notebook_create` - Crear nuevo cuaderno
- `notebook_list` - Listar cuadernos
- `notebook_get` - Obtener cuaderno
- `notebook_delete` - Eliminar cuaderno
- `notebook_rename` - Renombrar cuaderno
- `notebook_add_text` - Añadir texto
- `notebook_add_url` - Añadir URL
- `notebook_add_drive` - Añadir archivo de Drive
- `notebook_query` - Consultar cuaderno

### Fuentes
- `source_get_content` - Obtener contenido
- `source_delete` - Eliminar fuente
- `source_describe` - Describir fuente
- `source_list_drive` - Listar archivos de Drive
- `source_sync_drive` - Sincronizar Drive

### Studio (generación de contenido)
- `audio_overview_create` - Audio overview
- `video_overview_create` - Video overview
- `slide_deck_create` - Presentación
- `infographic_create` - Infografía
- `flashcards_create` - Tarjetas
- `quiz_create` - Cuestionario
- `mind_map_create` - Mapa mental
- `data_table_create` - Tabla de datos
- `report_create` - Reporte

### Investigación
- `research_start` - Iniciar investigación
- `research_status` - Estado de investigación
- `research_import` - Importar investigación

## IMPORTANTE: MSPs no están en el MCP

**Limitación**: El MCP de NotebookLM NO incluye herramienta para generar MSP.

### Cómo generar un MSP manualmente

1. **Ir a**: https://notebooklm.google.com
2. **Crear/abrir** un cuaderno con fuentes
3. **En el cuaderno**, hacer clic en **"More"** (tres puntos)
4. Seleccionar **"Generate MSP"** o **"Create paper"**
5. Esperar generación y descargar

### Alternativas para automatizar

- Usar la API de Google NotebookLM (si está disponible)
- Integrar con Vertex AI para generación de documentos
- Crear custom skill en Antigravity que use la web

## Verificar estado de conexión en código

```python
import subprocess
import json

def check_notebooklm_mcp():
    # Verificar ejecutable existe
    result = subprocess.run(
        ["ls", "-la", "/home/rmonla/.local/share/notebooklm-mcp/bin/notebooklm-mcp"],
        capture_output=True
    )
    
    if result.returncode != 0:
        return {"status": "error", "message": "Executable not found"}
    
    # Verificar auth
    with open("/home/rmonla/.notebooklm-mcp/auth.json") as f:
        auth = json.load(f)
    
    has_auth = bool(auth.get("cookies") and auth.get("csrf_token"))
    
    return {
        "status": "ok" if has_auth else "needs_auth",
        "auth": auth
    }
```

## Troubleshooting

| Problema | Solución |
|----------|----------|
| MCP no aparece conectado | Reiniciar Antigravity |
| Error de autenticación | Ejecutar `notebooklm-mcp-auth` |
| No hay herramientas disponibles | Verificar tokens en `~/.notebooklm-mcp/auth.json` |
| Timeout en requests | Aumentar `NOTEBOOKLM_QUERY_TIMEOUT` |

## Referencias

- Docs MCP: `docs/promp/Configuracion-MCP-Antigravity.md`
- Prompt NotebookLM: `docs/promp/Prompt NotebookLM MCP X Antigravity.md`