← Back to directory
P

PaperBanana

Community
Automated academic illustration for AI scientists
GitHub source repository ↗
★ 2.3k Stars Category · Other Very popular Source revision 8b4745ad3024
49FMRS · D
Reliability
9/20
Security and permissions
8/20
Maintenance
10/20
Documentation
11/20
Setup experience
11/20

This is a powerful MCP server specifically for academic figure generation, offering rich tools and configuration options. It's ideal for researchers to automate diagram creation but requires familiarity with multiple API providers and configuration.

Read the FMRS scoring method →

PaperBanana is an open-source MCP server implementing and extending Google Research's PaperBanana for automated generation of publication-quality academic diagrams and statistical plots from text descriptions. It supports multiple providers including OpenAI, Azure, Gemini, and Atlas Cloud, featuring a two-phase multi-agent pipeline with iterative refinement for research automation and visualization.

Tools

generate_diagram
Generate a methodology diagram from text context and caption
continue_run
Continue refinement for an existing run directory (optional critic feedback)
generate_plot
Generate a statistical plot from JSON data and intent description
evaluate_diagram
Compare a generated diagram against a human reference on 4 dimensions
evaluate_plot
Compare a generated statistical plot against a human reference on 4 dimensions

Setup

Use the provided JSON config to run via uvx: uvx --from paperbanana[mcp] paperbanana-mcp, setting the GOOGLE_API_KEY environment variable (or OPENAI_API_KEY). Ensure Python 3.10+ and uv are installed.

claude_desktop_config.json
{
  "mcpServers": {
    "paperbanana": {
      "command": "uvx",
      "args": [
        "--from",
        "paperbanana[mcp]",
        "paperbanana-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key"
      }
    }
  }
}

Fit and risk

Best for

  • Researchers and scientists needing quick generation of paper figures
  • Automating paper writing and visualization workflows
  • Users requiring multi-provider support (OpenAI, Gemini, etc.)
  • Those who want multi-agent pipeline with iterative refinement

Not for

  • Users needing complex non-academic image generation (not suitable)
  • Users without API keys expecting full functionality
  • Users seeking real-time interactive drawing/editing

Required permissions

  • Requires API keys for VLM providers (e.g., OpenAI or Gemini)
  • Requires API keys for image generation providers (e.g., OpenAI or Gemini)
  • Needs file system access for reading inputs and writing outputs

Risks and side effects

  • API key management could lead to unexpected costs if misused
  • Generated content may contain biases or errors; human review needed
  • Dependency on third-party providers may be affected by outages or policy changes

Troubleshooting

  1. Ensure API keys are correctly set in environment variables.
  2. Verify input file paths are valid.
  3. Check that model names are correct.
  4. If generation fails, inspect output metadata and logs to diagnose issues.

Use cases

Generate methodology diagrams from paper text automatically
Create statistical plots from CSV/JSON data
Evaluate generated diagrams against human references
Batch-generate multiple diagrams and plots from manifests
Integrate automated figure generation into IDEs and Claude Code

Supported clients

Claude DesktopFull support