Canvas + Codex + Claude

    Banana Art Lab MCP Server

    让 Codex、Claude Code、Cursor 或任意 MCP 客户端使用 GPT Image 2、Nano Banana Pro、Seedream 及其他 Banana Art Lab 模型生成图像;消耗您的积分,并将生成结果直接呈现在你们协作的画布上。

    服务器 URL(Streamable HTTP,OAuth)
    https://trynanobanana.net/mcp
    Codex

    › 用 GPT Image 2 Saver 制作三张旅行海报,并放入名为“海报”的画布中

    ● banana-art-lab · generate_image

    model: gpt-image-2-saver · ratio 3:4 · 3 images

    3 张图片 · 6 积分 · 已放置在画布“海报”

    已完成。打开 trynanobanana.net/canvas 即可对比查看,或者告诉我你想精修哪一张。

    trynanobanana.net/canvas · 海报
    提示词
    旅行海报,温暖的印刷色彩,醒目的排版
    使用 GPT Image 2 Saver 生成的京都旅行海报
    使用 GPT Image 2 Saver 生成的雨天街景
    使用 GPT Image 2 Saver 生成的书店内部场景

    配置

    连接您的 AI 助手

    Codex

    添加服务器后登录:Codex 会在浏览器中打开 trynanobanana.net 以批准授权。

    codex mcp add banana-art-lab --url https://trynanobanana.net/mcp
    codex mcp login banana-art-lab
    在 Codex 中生成图像

    Claude Code

    添加服务器后,在 Claude Code 中输入 /mcp,选择 banana-art-lab 并完成登录。

    claude mcp add --transport http banana-art-lab https://trynanobanana.net/mcp
    在 Claude Code 中生成图像

    Cursor

    将其添加到 ~/.cursor/mcp.json(或项目的 .cursor/mcp.json)。Cursor 会在首次使用时提示你登录。

    mcp.json
    {
      "mcpServers": {
        "banana-art-lab": {
          "url": "https://trynanobanana.net/mcp"
        }
      }
    }

    其他客户端或使用 API Key

    将 https://trynanobanana.net/mcp 添加为远程 HTTP MCP 服务器。支持 OAuth 的客户端会提示您登录;对于其他客户端,可在画布的“设置 → AI 工具”中创建 API Key,并作为 Bearer Token 发送。在 Codex 中,将 Key 存入 BANANA_ART_LAB_API_KEY 环境变量即可:

    codex mcp add banana-art-lab --url https://trynanobanana.net/mcp --bearer-token-env-var BANANA_ART_LAB_API_KEY

    工具

    您的助手能做什么

    工具功能说明
    generate_image根据提示词和可选参考图生成 1-4 张图像,支持站内任意模型、宽高比及分辨率。还可选择将提示词和结果放置在画布上。
    get_generation获取耗时超过约 45 秒的生成任务的图像。
    list_models列出可用模型、分辨率、画质级别及每张图像所需的积分。
    get_account显示已连接账户的积分余额。
    list_canvases列出您的所有画布及其 ID。
    get_canvas读取画布内容:包含节点(文本、图像、位置)与连线关系。
    create_canvas创建新画布。
    edit_canvas在画布上添加、更新、连接或删除节点。

    可以这样问

    • “用 GPT Image 2 Saver 生成四张白色大理石上的陶瓷咖啡杯产品图,并放到名为“Mug launch”的新画布上。”
    • “读取我的“Spring campaign”画布,并将其中的每张图像都生成 16:9 比例的版本。”
    • “列出 Banana Art Lab 的模型及其价格,然后用 Nanobanana Pro 生成一张 2K 的夜市海报。”
    • “把这段产品描述拆成我画布上的三个提示词节点,各自连接一张图像并完成生成。”

    权限与安全

    账户权限完全由您掌控

    • 您只需登录并在 trynanobanana.net 上为每个应用授权,第三方应用绝不会接触您的密码。
    • 访问令牌有效期为 1 小时并会自动续期;您可随时在“画布设置 → AI 工具”中解绑应用或撤销密钥。
    • 服务器仅在您的助手发起请求时生成图片,积分价格与网站完全一致(请参阅模型与价格)。
    • 它仅使用您的 Banana Art Lab 账户,无法访问您电脑上的本地文件。

    常见问题

    什么是 Banana Art Lab MCP 服务器?

    MCP(Model Context Protocol)是 Codex、Claude Code 和 Cursor 等 AI 助手调用外部工具的标准协议。位于 https://trynanobanana.net/mcp 的 Banana Art Lab MCP 服务器为它们赋予了图像生成与画布操作能力,让您在日常工作的对话窗口中即可直接生成图像。

    支持连接哪些应用?

    任何支持远程(Streamable HTTP)服务器的 MCP 客户端均可连接。Codex、Claude Code 和 Cursor 支持通过 OAuth 登录:只需在 trynanobanana.net 上授权一次即可。不支持 OAuth 的客户端可以使用在画布“设置 → AI 工具”中获取的 API Key。

    费用是多少?

    工具本身完全免费连接。每生成一张图像消耗的积分与官网价格一致,例如使用 GPT Image 2 Saver 生成任意分辨率均为 2 积分。新账户注册即送 10 免费积分,您也可以在价格页面购买更多积分。

    AI 能查看我的画布并消耗我的积分吗?

    仅在您于授权页面确认许可后,且仅限您所授权的账户。它无法访问您电脑上的本地文件。您可以随时在画布“设置 → AI 工具”中解绑应用或吊销 API Key。

    为什么有时生成结果会返回为一个任务(job)?

    Codex 默认等待工具响应约 60 秒。如果图像未能在约 45 秒内生成完毕,generate_image 会返回一个任务 ID,随后您的助手会通过 get_generation 稍后拉取图像。这不会重复扣除积分。

    画布的修改会在哪里显示?

    会直接同步在 trynanobanana.net/canvas 的画布中。如果当前已打开画布,助手的更改将在约 10 秒内显示;若未打开,下次进入即可看到。