graph TD
    subgraph "Clientes MCP & Agentes"
        AG["🤖 Claude Code / OpenAI Codex / Antigravity / Cursor"]
    end

    subgraph "Hub Desktop (Rust + egui/eframe)"
        DESK["🖥️ MCPCONECCT Desktop App<br/>(Async mpsc · Multi-Filtros · Modo Oscuro/Claro)"]
    end

    subgraph "Capa Central MCPCONECCT"
        MCP["🔌 Servidor MCP (run_mcp.py)<br/>Protocolo stdio / SSE"]
        API["🌐 FastAPI Backend (run_dashboard.py:8765)<br/>REST Endpoints · Web Dashboard"]
        TRANS["📐 Core Engine<br/>Traductor Booleano · Linters PICO · Parser cURL"]
        DB["🗄️ SQLite Database<br/>Audit Registry & Export History"]
    end

    subgraph "Navegación e Interceptación"
        BURP["🛡️ Burp Suite Proxy (127.0.0.1:8080)"]
        FF["🦊 Firefox Profile (cookies.sqlite)"]
    end

    subgraph "Plataformas Académicas"
        IEEE["⚡ IEEE Xplore<br/>(Refinements Facets & Wildcard Linter)"]
        SCOPUS["🔬 Scopus (Elsevier)<br/>(SPA Gateway & DOCTYPE Filters)"]
        SPRINGER["📚 Springer Nature<br/>(Open Index & Public Search)"]
    end

    AG -->|JSON-RPC stdio| MCP
    DESK -->|HTTP REST| API
    MCP --> TRANS
    API --> TRANS
    TRANS --> DB
    FF -.->|1-Clic Session Extraction| TRANS
    TRANS -->|Opcional HTTP Proxy| BURP
    BURP --> IEEE
    BURP --> SCOPUS
    BURP --> SPRINGER
    TRANS --> IEEE
    TRANS --> SCOPUS
    TRANS --> SPRINGER

git clone https://github.com/glender222/MCPCONECCT.git
cd MCPCONECCT

# Crear y activar entorno virtual
python3 -m venv venv
source venv/bin/activate

# Instalar dependencias
pip install --upgrade pip
pip install -e .

cp config/auth_store.example.json config/auth_store.json
cp .env.example .env

./run_desktop.sh

cd desktop_app
cargo run --release

# Inicia la API y el centro de control en http://127.0.0.1:8765
./venv/bin/python run_dashboard.py --port 8765

{
  "mcpServers": {
    "mcpconecct": {
      "command": "/ruta/absoluta/a/mcpconecct/venv/bin/python",
      "args": [
        "/ruta/absoluta/a/mcpconecct/run_mcp.py",
        "--transport",
        "stdio"
      ],
      "env": {
        "BURP_PROXY_ENABLED": "false"
      }
    }
  }
}

{
  "mcpServers": {
    "mcpconecct": {
      "command": "/ruta/absoluta/a/mcpconecct/venv/bin/python",
      "args": ["/ruta/absoluta/a/mcpconecct/run_mcp.py", "--transport", "stdio"]
    }
  }
}

# Ejecutar suite de pruebas
pytest tests/ -v

============================== 21 passed in 0.78s ==============================

MCPCONECCT/
├── assets/                     # Capturas de pantalla e ilustraciones para documentación
│   ├── hero_desktop.png        # Interfaz de búsqueda multi-filtro en Rust
│   ├── connections_auth.png    # Panel de gestión de conexiones y Burp Suite
│   ├── pico_linters.png        # Calibrador PICO y validadores sintácticos
│   └── web_dashboard.png       # Dashboard web de métricas y telemetría
├── config/                     # Configuraciones y plantillas seguras
│   ├── auth_store.example.json # Plantilla de credenciales (auth_store.json en .gitignore)
│   ├── settings.py             # Parámetros del proxy y rutas
│   └── syntax_rules.json       # Reglas de comodines y sintaxis por biblioteca
├── core/                       # Núcleo analítico y traductores
│   ├── audit.py                # Base de datos SQLite para registro de agentes
│   ├── http_client.py          # Cliente HTTP con soporte proxy Burp y SSL bypass
│   ├── query_parser.py         # Analizador de sintaxis y balanceo
│   ├── query_translator.py     # Traductor a sintaxis canónica / nativa
│   └── query_validator.py      # Linter de límites de comodines por base
├── dashboard/                  # Dashboard web reactivo (FastAPI + Tailwind)
│   ├── routes/                 # Endpoints REST y vistas web
│   └── templates/              # Vistas HTML / Tailwind
├── desktop_app/                # Aplicación Desktop nativa en Rust (egui/eframe)
│   ├── src/                    # Código fuente en Rust (app, burp, db, translator)
│   └── Cargo.toml              # Manifiesto de paquetes Rust
├── exporters/                  # Generadores de formatos de salida
│   ├── bibtex_exporter.py      # Generador de archivos .bib
│   └── csv_exporter.py         # Generador de archivos .csv
├── exports/                    # Directorio de salida de exportaciones (ignorado en git)
├── mcp_server/                 # Servidor oficial Model Context Protocol
│   ├── tools/                  # Definiciones de herramientas y esquemas Pydantic
│   └── server.py               # Servidor FastMCP
├── platforms/                  # Adaptadores a motores de búsqueda
│   ├── ieee.py                 # Integración IEEE Xplore con refinements nativos
│   ├── scopus.py               # Integración Scopus SPA Gateway y DOCTYPEs
│   └── springer.py             # Integración Springer Open Index
├── tests/                      # Suite de pruebas automatizadas (pytest)
├── .env.example                # Plantilla de variables de entorno
├── .gitignore                  # Exclusiones estrictas para seguridad y limpieza
├── LICENSE                     # Licencia MIT de código abierto
├── pyproject.toml              # Manifiesto Python y metadatos de versión 1.0.0
├── run_dashboard.py            # Script de inicio del Dashboard Web
├── run_desktop.sh              # Script de inicio del aplicativo Desktop
└── run_mcp.py                  # Script de inicio del servidor MCP stdio