---
name: init-jupyter
description: Inicializa un proyecto Python con uv, Jupyter Lab y configura MCP para Claude
argument-hint: [ruta-proyecto]
disable-model-invocation: true
user-invocable: true
allowed-tools: Bash, Read, Write, Edit
---

# Inicializar Proyecto Jupyter

Este skill automatiza la configuración completa de un entorno de análisis de datos con Jupyter Lab integrado con Claude via MCP.

## Pasos a ejecutar

1. **Validar ubicación**
   - Si se proporciona `$1`, usar esa ruta
   - Si no, usar el directorio actual

2. **Inicializar proyecto con uv**
   ```bash
   cd [ruta] && uv init
   ```

3. **Crear entorno virtual**
   ```bash
   uv venv
   ```

4. **Instalar dependencias**
   ```bash
   uv add jupyter jupyter-collaboration
   ```

5. **Instalar jupyter-mcp-server**
   ```bash
   uv tool install jupyter-mcp-server
   ```

6. **Configurar MCP para Claude**
   - Crear o actualizar `.claude/settings.local.json` con la configuración del servidor MCP de Jupyter:
   ```json
   {
     "mcpServers": {
       "jupyter": {
         "command": "jupyter-mcp-server",
         "args": []
       }
     }
   }
   ```

7. **Crear script de lanzamiento** `start-jupyter.sh`:
   ```bash
   #!/bin/bash
   source .venv/bin/activate
   .venv/bin/jupyter lab --no-browser --NotebookApp.token='' --NotebookApp.password='' --NotebookApp.disable_check_xsrf=True
   ```

8. **Mostrar resumen al usuario** con los comandos para:
   - Activar el entorno: `source .venv/bin/activate`
   - Lanzar Jupyter: `./start-jupyter.sh` o el comando directo

## Ejemplos de uso

**Inicializar en directorio actual:**
```bash
/init-jupyter
```

**Inicializar en ruta específica:**
```bash
/init-jupyter ~/proyectos/mi-analisis
```

## Notas

- Si el proyecto ya tiene `pyproject.toml`, preguntar antes de sobrescribir
- El script `start-jupyter.sh` se crea con permisos de ejecución
- La configuración MCP se guarda en `.claude/settings.local.json` del proyecto