EvoLink MCP - EvoLink.AI

CLI/MCP 总览可以按客户端选择入口；模型费用、任务素材和 Agent 资料集中在同一栏目的共用资料。 EvoLink MCP 把模型查询、估价、三媒体生成、素材上传、任务和余额作为原生工具提供给 Agent。本栏目只讲 MCP；终端命令与 evolink-cli 技能见独立 CLI 栏目。以已发布 MCP 1.6.1 为参考。远程有15个工具，浏览器OAuth登录；本地stdio有13个工具，使用个人API Key。当前账户模型与参数仍须实际查询。

选择您的助手

远程连接地址为 https://mcp.evolink.ai/mcp，传输是 Streamable HTTP。按客户端自己的入口完成授权，不把文档 URL 当作服务地址。

Claude

添加远程连接器，在浏览器授权。

Codex

注册远程服务器并完成独立 MCP OAuth。

Claude Code

添加 HTTP MCP，通过 /mcp 完成授权。

ChatGPT

添加自定义 MCP 连接，登录并启用工具。

Cursor

配置服务器 URL，并通过客户端授权。

OpenClaw

在支持 OAuth 的 Gateway 版本配置连接。

Hermes

合并 MCP 配置，登录并重载工具。

其他 MCP 客户端

通用 Streamable HTTP 与 OAuth 分步设置。

本地 MCP

npx 启动 stdio 服务，用个人 API Key 验证。

快速开始：远程 MCP

添加服务器

在 MCP/连接器设置选择自定义服务器，名称 EvoLink，URL 填 https://mcp.evolink.ai/mcp。按上方客户端指南操作，不需要安装本地 MCP 包。

浏览器登录并授权

选择 OAuth，在浏览器登录 EvoLink，核对账户和权限并允许，回到客户端。确认连接与工具已启用；CLI 登录不替代宿主 MCP 授权。

免费验证工具可调用

发送下面提示词，确认实际获得余额和可用模型：

请使用 EvoLink 查询账户余额，并搜索可用图片模型，先不要生成任何内容。

成功标志是 check_balance 和 search_models 的真实返回结果，不只是有工具列表。此验证不创建付费媒体任务。

仅支持stdio的客户端请按本地MCP安装，两种认证和启动方式分别完成。

第一次生成

连接成功后，直接描述需求：

图片
视频
音频

用 EvoLink 做一张咖啡品牌广告图：暖色、奶油白陶瓷杯、晨光，上方预留品牌文案。
先比较适合的模型，展示输出规格、本次估价与限制，等我确认后生成。
完成后返回原图链接和实际扣费，不要自动重做或另行修改原结果。

用 EvoLink 做一段海边日落短视频。先给我可用模型、支持的时长与画质、声音选项和报价。
确认后再提交，保存任务 ID，查询到完成后给我原视频链接和实际扣费。

用 EvoLink 生成中文欢迎语音，内容是“欢迎来到我们的咖啡店”。
先选语音模型，核对声音、输入参数和计费方式，等我确认后生成并返回原音频。

生成使用 EvoLink 积分。提示词要求智能体等批准；账户登录、宿主工具许可、单次费用批准是不同步骤。MCP 不提供会话级服务端批准按钮，需由智能体取得本次明确批准。预算范围见费用与授权。

怎么接入

远程 MCP：您的助手 → EvoLink MCP → 平台 API。助手管理 OAuth 登录，远程服务管理工具执行。浏览器聊天客户端不需要安装 Node.js 或 EvoLink CLI。本地 stdio：您的助手 → 本地 MCP 进程 → 平台 API。需要在助手实际运行的机器安装 Node.js 18+，由助手启动 MCP 进程，并向进程提供平台 API Key。详细配置见其他 MCP 客户端。两种模式使用相同的主要模型、报价、生成和任务工具；远程额外提供 prepare_upload、get_upload。技能与插件是可选的操作说明，不能代替服务配置、账户授权或宿主工具权限。

要完成的事情	使用的工具
查询账户余额和权限	`check_balance`
找模型、核对参数、查模型文档	`search_models`、`get_model`、`search_docs`
按需求比较候选模型	`recommend_models`
计算预计费用	`estimate_cost`
生成图片、视频、音频	`generate_image`、`generate_video`、`generate_audio`
查询与等待任务、查询历史	`get_task`、`list_tasks`
查看账户用量	`get_task_usage`
上传参考素材	`upload_file`；远程另有 `prepare_upload`、`get_upload`

工具不会提供代码开发、本地剪辑或网页搭建能力。宿主 Agent 自己可能有这些能力，介绍 EvoLink 时应明确它们属于宿主。

第一步：选模型并核对输入

先用 search_models 或 recommend_models 获取当前可用候选，再用 get_model 核对准确 ID、能力、必填字段和限制。需要更多说明时使用 search_docs。不要把模型系列名称当成可直接提交的模型 ID。推荐顺序、可比较的新款系列和费用规则统一见模型、费用与额度。先核对本次账户目录和输入，不把示例型号当成默认推荐。下面的示例使用 z-image-turbo。正式使用任何模型之前都应查参数：

{"name":"get_model","arguments":{"model":"z-image-turbo"}}

第二步：准备参考素材

纯文字生成可以跳过上传。需要参考图、视频或音频时，先确认模型支持该素材类型、数量与大小，再上传。

已有可访问 URL：通过 upload_file 的 file_url 上传。URL 需要能由服务端读取；用户电脑的文件路径不是公开 URL。
较小的内联文件：远程 upload_file 的 base64 内容上限为 1 MiB；必须提供匹配的 MIME。不要将大文件放进工具消息。
远程本地文件：先调用 prepare_upload，让具备文件读取与 HTTP 能力的环境上传文件，再调用 get_upload 核对回执。单次上传上限为 95 MiB，还需遵守模型限制。上传授权约 15 分钟过期、一次性使用，状态地址约保留 1 小时。
本地 stdio：upload_file 支持本地 file_path。这是 MCP 进程所在机器的绝对路径，不是聊天用户电脑的路径。实际限制以文件服务和模型为准。

{"name":"prepare_upload","arguments":{"file_name":"reference.png"}}

{"name":"get_upload","arguments":{"upload_id":"UPLOAD_ID"}}

聊天附件不会自动变成模型可用链接。如果助手没有读取或上传本地文件的能力，应让用户提供可访问 URL。上传结果不确定时保留原 upload_id 查询，不要立刻重复上传；回执兼容取决于文件服务部署。参考文件通常保留 72 小时，过期需要重新上传并更新输入。

第三步：图片报价、批准和生成

先整理最终输入，再计算报价；向用户展示模型、图片数量、尺寸、内容和预计费用。报价不是实际结算保证。当前发布版本的价格覆盖与限制见费用说明。

{"name":"estimate_cost","arguments":{"model":"z-image-turbo","input":{"prompt":"A minimalist coffee advertisement with a ceramic cup"}}}

只有用户批准本次方案与预计费用之后，才调用生成工具。client_request_id 是 16–96 字符的稳定请求编号；同一次提交重试必须沿用原编号和原输入。下面的预算值仅是参数示例，实际按用户明确的预算设置：

{"name":"generate_image","arguments":{"model":"z-image-turbo","input":{"prompt":"A minimalist coffee advertisement with a ceramic cup"},"client_request_id":"coffee-image-demo-001","max_cost_usd":1}}

max_cost_usd 只用于提交前检查，不能保证最终扣费不超出它；estimate_cost 本身不接受这个参数。不要把宿主允许调用工具当成用户批准这笔费用。

视频：先核对时长、分辨率、声音和参考输入

使用 get_model 查准确的文生／图生视频模型 ID。时长、分辨率、音频开关、参考视频等都可能影响价格，不能沿用另一组参数的报价。相同系列的不同任务类型也可能使用不同模型 ID。依次执行：核对参数 → 上传参考素材 → 用最终输入调用 estimate_cost → 展示方案并取得本次批准 → 用同一输入调用 generate_video → 查询原任务 → 交付原视频。需要 media_seconds 的报价以输入素材实际时长为依据；无法核实、报价不完整或预算无法比较时先停下询问。不要为解决灰色缩略图自动启动本地剪辑、重复生成或改动完成的视频。

音频：区分音乐和语音

音乐需求可比较当前可用的 Suno v6；旁白和配音用适合的语音模型。先查模型参数，确定文字、语言、声音、歌词、时长或参考音频，再用最终输入估价并确认，最后调用 generate_audio。不完整的音频计费信息不能写成免费。输出以完成任务的原始音频地址为准，多个结果都应保留，并说明实际格式与保存方法。

第四步：等待、查询和恢复原任务

生成调用可能直接返回结果，也可能返回 task_id。查询原任务，不重复提交生成。get_task.wait_seconds 可以在一次调用中等待，范围 0–45 秒；等待超时表示本次等待结束。

{"name":"get_task","arguments":{"task_id":"TASK_ID","wait_seconds":30}}

多个任务使用 list_tasks 的 task_ids 批量查询；历史列表也由该工具提供。提交超时而没有拿到任务编号时，保存原请求编号、输入、凭据与错误信息，按原请求恢复。不能换身份或新编号再生成来排错。当前没有可用的公开取消排队工具。停止 Agent 等待、关闭页面或断开 MCP 不会取消服务端任务，也不证明没有扣费或已经退款。

第五步：交付原始结果

任务完成后返回可打开的原始链接，并说明模型、输出数量、已知费用及链接有效期。原始生成文件通常保留 24 小时，应及时保存。宿主支持预览时可同时显示；只显示链接或灰色缩略图时先验证原始链接。下载前检查 HTTP 状态、内容类型和实际文件格式；错误页面不是媒体文件。Python 默认请求被拦截时可给受控下载代码设置产品 User-Agent，具体示例见下载排错。结果交付与预览问题不能通过未经批准的再生成修复。用户另行要求剪辑或改图时，再按对应宿主能力与费用确认执行。需要按工具名称查参数与返回值，请看MCP 工具参考。需要让 Agent 阅读完整规则，请看技能与可读资料。

​选择您的助手

Claude

Codex

Claude Code

ChatGPT

Cursor

OpenClaw

Hermes

其他 MCP 客户端

本地 MCP

​快速开始：远程 MCP

​第一次生成

​怎么接入

​第一步：选模型并核对输入

​第二步：准备参考素材

​第三步：图片报价、批准和生成

​视频：先核对时长、分辨率、声音和参考输入

​音频：区分音乐和语音

​第四步：等待、查询和恢复原任务

​第五步：交付原始结果