# PaperBanana-CN

Turns a research description into a methodology diagram and CSV or JSON data into a statistical plot, then scores the result.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 84
- Author: mituan-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mituan-ai/PaperBanana-CN
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/paperbanana-cn

## What it does

The server starts with `paperbanana-cn mcp` and runs on the PaperBanana scientific workflow. A method figure comes from your text plus a caption; a chart comes from tabular input. Diagrams need two model connections: a VLM and an image service. Charts get by on the VLM alone. Each connection carries its own protocol, Base URL, key, model name and timeout, and the two roles can sit on one service or on separate ones.

The studio side adds quality evaluation through the VLM, resuming a saved run, batch jobs and parameter sweeps. Multi-panel composition and the run browser need no model at all. Output format is yours to pick: aspect ratios from `1:1` to `9:16` and `1K`, `2K` or `4K` resolution. The provider check happens before a request goes out, so an unsupported pair stops generation with an error.

Python 3.10–3.12 and `uv` have to be in place, plus a desktop browser if you plan to use the Studio. A saved profile does not switch on by itself: after editing fields pick “Save and use”, or the task runs with the old settings. Leaving the key field blank keeps the stored key. Ask for `16:9` at `2K` and the Studio shows the request size before anything is generated.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add paperbanana-cn -- uvx paperbanana-cn
```
uvx runs the command named after the package; if the README names another one, use uvx --from paperbanana-cn <command>

### Codex

**Platform CLI**
```bash
codex mcp add paperbanana-cn -- uvx paperbanana-cn
```
uvx runs the command named after the package; if the README names another one, use uvx --from paperbanana-cn <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "paperbanana-cn": {
            "command": "uvx",
            "args": [
                "paperbanana-cn"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from paperbanana-cn <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "paperbanana-cn": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "paperbanana-cn"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from paperbanana-cn <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add paperbanana-cn uvx paperbanana-cn
```
uvx runs the command named after the package; if the README names another one, use uvx --from paperbanana-cn <command>

## When to use it
- draw a method architecture diagram from paper text
- plot a line chart from `data.csv`
- get reviewer-style feedback on a finished figure
- sweep several aspect ratios for the same diagram
- combine separate panels into one composite figure

## Example prompts
- Generate a methodology diagram from `method.txt` with the caption “Overview of the proposed architecture”, aspect ratio `16:9`, resolution `2K`, png.
- Build a statistical plot from `results.csv` and evaluate its quality.
- Resume the last saved run and change only the aspect ratio to `4:3`.

## Similar
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5548
- [arxiv-mcp-server](https://affpapa.org/en/nevibecode/mcp/arxiv-mcp-server.md) — MCP server · ★ 3231
- [PaperBanana](https://affpapa.org/en/nevibecode/mcp/paperbanana.md) — MCP server · ★ 2417
- [MATLAB MCP Server](https://affpapa.org/en/nevibecode/mcp/matlab-mcp-server.md) — MCP server · ★ 1716
- [Hex Research](https://affpapa.org/en/nevibecode/mcp/hex-research.md) — MCP server · ★ 583
- [DocsAgent — Zotero, Obsidian & Apple Notes MCP Server](https://affpapa.org/en/nevibecode/mcp/docsagent-zotero-obsidian-apple-notes-mcp-server.md) — MCP server · ★ 578

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md