login
Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
force
io.github.runapi-builder由 GitHub 账号 runapi-builder 发布v0.2.1更新于 Oct 29, 2026
RunAPI MCP server for Nano Banana: create tasks, poll status, check pricing.
RunAPI 的 Nano Banana MCP 服务器让助手创建图像生成与图像编辑任务、查询任务状态,并查看模型价格。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
Nano Banana API access for AI agents: run image generation operations, poll asynchronous results, and check pricing through one focused MCP server.
Works with Claude Code, Codex, Cursor, Windsurf, VS Code, Roo Code, and any MCP-compatible host.
[npm version] [GitHub repository] [Apache-2.0 license] [MCP Server] [5 models]
Install | Tools | Models | Agent Prompts | Configuration | Links
@runapi.ai/nano-banana-mcp is a focused Model Context Protocol server for the Nano Banana model line on RunAPI.
It gives MCP-compatible assistants direct access to 2 endpoints and 5 model variants without loading the full RunAPI catalog.
Use this per-model server when an agent should stay scoped to Nano Banana. Use @runapi.ai/mcp when one assistant should discover every RunAPI model line.
Add it to Claude Code:
Use project scope when the server should be shared with a repository:
Codex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:
check_pricing works before sign-in. For task creation and status polling, ask your assistant to call the login tool. It opens a browser login and saves credentials to ~/.config/runapi/config.json, the same file used by runapi login.
Headless and CI hosts can still set RUNAPI_API_KEY before starting the MCP host.
Ready-made examples are in examples/ for Claude, Cursor, Windsurf, VS Code, and Roo Code.
Nano Banana covers 5 model variants across 2 endpoints. Each tool accepts the models listed for it:
Model availability can change between releases. Use check_pricing or the Nano Banana model page for the current catalog view.
Ask your assistant in natural language; it can inspect pricing, create the task, and return the task id plus output URLs.
The assistant can call check_pricing, then edit_image, and return the task id, status, and output URLs.
The assistant calls the create tool with wait: false and returns the task id. Check on it later with get_task.
The assistant calls check_pricing and can link to the Nano Banana model page for the canonical catalog entry.
The server resolves auth in this order:
RUNAPI_API_KEY environment variable, useful for headless and CI hosts~/.config/runapi/config.json, created by the MCP login tool or runapi logincheck_pricingThe config file is normally managed by login. A pre-provisioned headless config can use:
Do not commit real API keys.
Licensed under the Apache License, Version 2.0.
来源:README.md,提交 7d7b639
Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
forceCreate a Nano Banana task on RunAPI (edit image). Returns a task id, status, and output URLs.
waitmodelprompttimeout_msaspect_ratiocallback_urloutput_formatpoll_interval_mssource_image_urls必填Create a Nano Banana task on RunAPI (text to image). Returns a task id, status, and output URLs.
waitmodelprompttimeout_msaspect_ratiocallback_urloutput_formatpoll_interval_msoutput_resolutionreference_image_urlsFetch the current status and latest result payload for a nano-banana task.
action必填task_id必填Look up RunAPI pricing for the nano-banana model line.
modelaction已满足适用检查项的 90%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
claude mcp add nano-banana -s user -- npx -y @runapi.ai/nano-banana-mcpclaude mcp add nano-banana -s project -- npx -y @runapi.ai/nano-banana-mcp{ "mcpServers": { "nano-banana": { "command": "npx", "args": ["-y", "@runapi.ai/nano-banana-mcp"] } }}Run a Nano Banana edit image task with RunAPI.Create the task but don't wait for it to finish.Check current Nano Banana pricing, then create the task if it matches my request.{ "apiKey": "your_runapi_key"}