PaperBanana

Descrizione

PaperBanana è un’implementazione open source della community del paper PaperBanana sull’illustrazione accademica automatizzata. Trasforma testi di metodologia e didascalie in diagrammi e grafici statistici in stile da pubblicazione, usando una pipeline di agenti retriever, planner, stylist, visualizer e critic con raffinamento iterativo. Offre inoltre una CLI, un’API Python, la generazione in batch e una web UI Gradio locale.

Il server MCP si esegue in locale tramite stdio dal pacchetto PyPI paperbanana, avviato con uvx. Richiede Python 3.10 o successivo e una chiave API per un provider supportato: OpenAI o Azure OpenAI, Google Gemini, Atlas Cloud o OpenRouter. Non è affiliato agli autori del paper originale né a Google Research.

Cosa puoi fare

• Generare diagrammi di metodologia da testo e didascalia
• Creare grafici statistici da dati CSV o JSON
• Raffinare l’output in modo iterativo con un agente critic
• Ottimizzare testo e didascalie prima della generazione
• Eseguire la generazione in batch da un file manifest
• Usare modelli OpenAI, Azure, Gemini, Atlas Cloud o OpenRouter

Tool

I server locali mostrano i loro tool solo quando sono in esecuzione, e questo non pubblica l’elenco in anticipo. Il tuo client li mostra dopo che lo hai aggiunto.

Prompt di esempio

• Genera un diagramma del mio metodo encoder-decoder a partire da questa descrizione

• Crea un grafico a barre da results.csv per il mio paper

• Crea una figura di panoramica con la didascalia 'Our agent framework'

• Raffina l’ultimo diagramma in base al mio feedback sul layout

Configurazione

Ogni client avvia PaperBanana sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.

claude mcp add --transport stdio paperbanana -- uvx paperbanana

{
  "mcpServers": {
    "paperbanana": {
      "command": "uvx",
      "args": [
        "paperbanana"
      ]
    }
  }
}

{
  "mcpServers": {
    "paperbanana": {
      "command": "uvx",
      "args": [
        "paperbanana"
      ]
    }
  }
}

code --add-mcp '{"name":"paperbanana","type":"stdio","command":"uvx","args":["paperbanana"]}'

{
  "servers": {
    "paperbanana": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "paperbanana"
      ]
    }
  }
}

{
  "mcpServers": {
    "paperbanana": {
      "command": "uvx",
      "args": [
        "paperbanana"
      ]
    }
  }
}

codex mcp add paperbanana -- uvx paperbanana

[mcp_servers.paperbanana]
command = "uvx"
args = ["paperbanana"]

gemini mcp add paperbanana uvx paperbanana

{
  "mcpServers": {
    "paperbanana": {
      "command": "uvx",
      "args": [
        "paperbanana"
      ]
    }
  }
}

Embed

Mostra PaperBanana in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed

Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.

Badge per il README Card per il sito iframe JSON Prompt per l’AI

Badge per il README

Markdown

[![PaperBanana on mcp.tc](https://mcp.tc/i/paperbanana/badge.svg)](https://mcp.tc/i/paperbanana)

HTML

<a href="https://mcp.tc/i/paperbanana"><img src="https://mcp.tc/i/paperbanana/badge.svg" alt="PaperBanana on mcp.tc" height="20"></a>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Card per il sito

HTML

<script src="https://mcp.tc/w/paperbanana.js" async></script>

La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.

iframe

HTML

<iframe src="https://mcp.tc/embed/paperbanana" title="PaperBanana on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).

https://mcp.tc/i/paperbanana.json

Cosa significa ogni campo

Prompt per l’AI

Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di PaperBanana al tuo sito.

Markdown

Aggiungi al mio sito la card di mcp.tc per PaperBanana, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.

Metti questo tag dove deve comparire la card. La card appare subito prima del tag:

```html
<script src="https://mcp.tc/w/paperbanana.js" async></script>
```

Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.

```html
<div data-mcptc="paperbanana"><a href="https://mcp.tc/i/paperbanana">PaperBanana on mcp.tc</a></div>
```

Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.

Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).

Per un README o altra documentazione in Markdown, usa invece il badge:

```markdown
[![PaperBanana on mcp.tc](https://mcp.tc/i/paperbanana/badge.svg)](https://mcp.tc/i/paperbanana)
```

Riferimento: https://mcp.tc/it/embed

Cronologia delle modifiche

Questo server gira sul tuo computer, quindi seguiamo il suo pacchetto PyPI: qui compare ogni nuova versione, insieme alle modifiche di chi lo gestisce.

1. 6 ott 2026, 21:22 UTC, Controllo automatico

   Inizio del tracciamento: versione 0.3.0.

Domande frequenti