PaperBanana-CN について
PaperBanana-CN は、学術論文向けの手法図と統計プロットを生成するオープンソースツールで、生成した図の評価にも対応します。論文図を作成する研究者を対象とし、VLM と画像サービスの接続をそれぞれ独立して設定できます。
主な機能
- 01手法の説明文からの手法図生成
- 02CSV または JSON データからの統計プロット生成
- 03VLM と画像サービスの独立した接続設定
- 04日本語と英語に対応した Studio とコマンドライン
- 05アスペクト比と解像度の選択
活用シーン
- 01論文の手法セクションから概要図を作成
- 02実験データを統計プロットに変換
- 03MCP クライアントから執筆ワークフロー内で図の生成を実行
MCP 対応
本プロジェクトは paperbanana-cn mcp で起動する MCP サーバーで、11 のツールを MCP クライアントに公開します。Studio やコマンドラインと同じ保存済みの接続設定を利用します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
11掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| config | any | いいえ | |
| caption | string | はい | 図が伝える内容を説明する図キャプション。 |
| optimize | boolean | いいえ | 生成前にコンテキストを補い、キャプションを改善します(デフォルトは True)。 False に設定すると、前処理を省略して結果を早く得られます。 |
| iterations | integer | いいえ | 改善の反復回数(デフォルトは 3、auto_refine=False の場合に使用)。 |
| auto_refine | boolean | いいえ | 評価者が満足するまでループします(デフォルトは True、最大 30 回反復)。 False に設定すると、固定回数の反復を使用して結果を早く得られます。 |
| aspect_ratio | any | いいえ | 目標アスペクト比。対応値: 1:1、4:3、3:2、5:4、16:9、21:9、4:5、3:4、2:3、9:16。 |
| input_images | any | いいえ | ユーザーが提供する参照画像/スケッチの任意のファイルパス (手描きのスケッチ、ホワイトボードの写真、以前の図)です。生成する図のレイアウトと内容の 参考にします。 |
| source_context | string | はい | 方法論セクションのテキストまたは関連論文の抜粋。 |
| vlm_connection | any | いいえ | |
| generate_caption | boolean | いいえ | 生成後に、出版用の図キャプションを自動生成します。 True の場合、キャプションは画像メタデータ(PNG tEXt チャンク、キー "Caption")に埋め込まれ、ログに記録されます。 |
| image_connection | any | いいえ | |
| output_resolution | string | いいえ | |
| legacy_connections | boolean | いいえ |
詳細
English · 简体中文
PaperBanana-CNは、研究内容の説明から方法論図を、CSVまたはJSONデータから統計プロットを生成します。 PaperBananaの科学ワークフローを利用し、VLMと画像サービスへの個別の接続、中国語のStudioインターフェース、 明示的なアスペクト比と解像度の設定を追加しています。
入力から図までをワンステップで
この録画では、方法論図の作成が入力の送信から完成結果まで進む様子を紹介します。
はじめる前に
Python 3.10-3.12、uv、デスクトップブラウザーが必要です。
| 作業 | 必要なモデル接続 |
|---|---|
| 方法論図 | VLMと画像生成 |
| 統計プロット | VLMのみ |
| マルチパネル構成と実行履歴の閲覧 | なし |
各接続では、プロトコル、Base URL、APIキー、モデル名、タイムアウトを個別に指定します。VLMと画像生成には、同じサービスまたは別々のサービスを使用できます。
クイックスタート
1. Studioを起動する
uvx paperbanana-cn studio
http://127.0.0.1:7860を開きます。uvxはパッケージを隔離された環境で実行するため、DebianやUbuntuのシステムPythonは変更されません。
2. モデル接続を追加する
Settings → VLM connectionを開き、サービスの各項目を入力して、Save and useを選択します。方法論図を生成する前に、Image connectionでも同じ操作を行います。
保存済みの接続を編集しても、有効にはなりません。APIキー欄が空の場合、保存済みのキーが保持されます。Studioは保存済みのキーをブラウザーに再表示しません。
3. 図を生成する
Methodology diagramを開き、手法の内容と図のキャプションを入力して、アスペクト比、解像度、出力形式を選択します。
同じ作業をCLIから実行する場合:
paperbanana-cn generate \
--input method.txt \
--caption "Overview of the proposed architecture" \
--aspect-ratio 16:9 \
--resolution 2K \
--format png
PaperBanana-CNで追加される機能
VLM と画像の接続を個別に設定
2 つのモデルの役割は、プロトコル、ベース URL、API キー、モデル、タイムアウトの設定をそれぞれ個別に持ちます。 Studio、CLI、MCP は同じ保存済み接続を参照します。保存済みプロファイルには認証情報への参照が含まれます。API キーはリポジトリと実行メタデータの外部に保持されます。
公式 API、OpenAI 互換サービス、Gemini 互換サービスに対応しています。プロバイダー固有の処理はアダプター側にとどまり、科学的なワークフローには影響しません。
中国語と英語に対応した Studio
Studio のインターフェース、ヘルプテキスト、検証、進行状況メッセージ、エラーは、中国語と英語で利用できます。インターフェースの言語を変更しても、プロンプト、論文のテキスト、生成された図のラベルは書き換えられません。
アスペクト比と解像度
対応するアスペクト比:
1:1 · 4:3 · 3:2 · 5:4 · 16:9 · 21:9 · 4:5 · 3:4 · 2:3 · 9:16
解像度の段階:
1K · 2K · 4K
Studio では、生成前にリクエストのサイズまたはプロバイダー固有の段階を表示します。アダプターが選択された組み合わせを生成できない場合、検証によってリクエストを停止し、未対応のオプションを報告します。
Studio のワークフロー
| 領域 | ワークフロー | モデル接続 |
|---|---|---|
| 作成 | 方法論図 | VLM と画像 |
| 作成 | 統計プロット | VLM |
| 改善 | 保存済みの実行を続行 | 保存済みの実行に依存 |
| 改善 | 品質評価 | VLM |
| 自動化 | 論文全体のオーケストレーション | VLM と画像 |
| 自動化 | バッチ生成 | タスクの種類に依存 |
| 自動化 | パラメーター探索 | VLM と画像 |
| ツール | 複数パネルの合成 | なし |
| ツール | 実行ブラウザー | なし |
方法論図ワークスペース
合成デモデータを使用した統計プロットワークスペース
CLI、MCP、Docker、Colab
| エントリーポイント | コマンドまたはリンク |
|---|---|
| Studio | paperbanana-cn studio |
| CLI | paperbanana-cn generate --help |
| MCP サーバー | paperbanana-cn mcp |
| GitHub Action | Action のリファレンス |
| Docker | ghcr.io/mituan-ai/paperbanana-cn:2.0.1 |
| Colab | クイックスタートノートブック |
MCP クライアントの設定
{
"mcpServers": {
"paperbanana-cn": {
"command": "uvx",
"args": ["paperbanana-cn", "mcp"]
}
}
}
サーバーは 11 個のツールを提供し、Studio および CLI と同じ有効な接続を読み込みます。ツールの一覧と引数については、MCP ガイドを参照してください。
Docker
docker run --rm -p 7860:7860 \
-v paperbanana-cn-config:/home/paperbanana/.config/paperbanana-cn \
-v paperbanana-cn-data:/home/paperbanana/.local/share/paperbanana-cn \
-v paperbanana-cn-outputs:/work/outputs \
ghcr.io/mituan-ai/paperbanana-cn:2.0.1 \
studio --host 0.0.0.0
永続的なインストール、ソースのセットアップ、オプションのプロバイダー
uv 管理の環境にコマンドをインストールします:
uv tool install paperbanana-cn
paperbanana-cn studio
現在のソースチェックアウトを実行します:
git clone https://github.com/mituan-ai/PaperBanana-CN.git
cd PaperBanana-CN
uv sync
uv run paperbanana-cn studio
デフォルトのパッケージには、Studio、MCP、PDF 入力、OpenAI 互換サービス、Gemini が含まれます。
| オプションのアダプター | インストール |
|---|---|
| AWS Bedrock | uv tool install "paperbanana-cn[bedrock]" |
| Anthropic | uv tool install "paperbanana-cn[anthropic]" |
| LiteLLM | uv tool install "paperbanana-cn[litellm]" |
| すべてのオプションプロバイダー | uv tool install "paperbanana-cn[all-providers]" |
CI では、paperbanana-cn connections add --api-key-env ENV_VAR を使用すると、コマンドラインの値ではなく環境変数からキーを読み込めます。
V2 は main で、paperbanana-cn ディストリビューション、paperbanana_cn Python モジュール、paperbanana-cn コマンドとして保守されています。
科学図生成の中核部分は、llmsresearch/paperbanana を基にしています。PaperBanana-CN は非公式のコミュニティ実装であり、上流の作者とは無関係で、推奨も受けていません。
コミュニティ
PaperBanana-CN は MIT License の下で、mituan が保守しています。
- 使用方法に関する質問は Discussions でお寄せください。
- 再現可能なバグは Issues で報告してください。
- 脆弱性は Private Vulnerability Reporting から報告してください。
- プルリクエストを作成する前に、CONTRIBUTING.md をお読みください。
開発時のチェック
git clone https://github.com/mituan-ai/PaperBanana-CN.git
cd PaperBanana-CN
uv sync --extra dev
uv run pytest tests/ -q
uv run ruff check paperbanana_cn/ mcp_server/ tests/ scripts/
API キー、非公開のリレー URL、未公開の論文、非公開のデータセット、ローカル接続ストア、生成された実行ディレクトリをアップロードしないでください。
スター履歴
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。