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.3.1更新于 Oct 29, 2026
RunAPI MCP server for Seedream: create tasks, poll status, check pricing.
RunAPI Seedream MCP 服务器,让助手创建文生图、图像编辑和图层分解任务、轮询任务状态并查询价格。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
Seedream 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] [9 models]
Install | Tools | Models | Agent Prompts | Configuration | Links
@runapi.ai/seedream-mcp is a focused Model Context Protocol server for the Seedream model line on RunAPI.
It gives MCP-compatible assistants direct access to 3 endpoints and 9 model variants without loading the full RunAPI catalog.
Use this per-model server when an agent should stay scoped to Seedream. 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.
Seedream covers 9 model variants across 3 endpoints. Each tool accepts the models listed for it:
Model availability can change between releases. Use check_pricing or the Seedream 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 decompose_layers, 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 Seedream 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,提交 aefcefb
Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
forceCreate a Seedream task on RunAPI (decompose layers). Returns a task id, status, and output URLs.
sizewaitmodelpromptimage_url必填timeout_mscallback_urloutput_formatpoll_interval_msCreate a Seedream task on RunAPI (edit image). Returns a task id, status, and output URLs.
seedwaitmodelpromptbackgroundtimeout_msaspect_ratiocallback_urloutput_countoutput_formatoutput_qualitypoll_interval_ms另有 3 个Create a Seedream task on RunAPI (text to image). Returns a task id, status, and output URLs.
seedwaitmodelprompttimeout_msaspect_ratiocallback_urloutput_countoutput_formatoutput_qualitypoll_interval_msoutput_resolution另有 1 个Fetch the current status and latest result payload for a seedream task.
action必填task_id必填Look up RunAPI pricing for the seedream model line.
modelaction已满足适用检查项的 90%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
claude mcp add seedream -s user -- npx -y @runapi.ai/seedream-mcpclaude mcp add seedream -s project -- npx -y @runapi.ai/seedream-mcp{ "mcpServers": { "seedream": { "command": "npx", "args": ["-y", "@runapi.ai/seedream-mcp"] } }}Run a Seedream decompose layers task with RunAPI.Create the task but don't wait for it to finish.Check current Seedream pricing, then create the task if it matches my request.{ "apiKey": "your_runapi_key"}