avots

avots-mcp

面向 avots.ai 的官方 MCP（Model Context Protocol）服务——一个多供应商 AI 平台。

只需一次连接，即可使用：

• 🖼 图像生成与编辑 - Nano Banana（Gemini 3 Pro / 3.1 Flash）、GPT-5 Image、FLUX、Recraft（包括原生矢量 SVG）、Ideogram
• 🎬 视频生成与编辑 - Veo 3.1、Seedance 2.0、Kling v3.0 Pro、Sora 2 Pro、Grok Imagine、Gemini Omni Flash（异步，1-8 分钟）；还可对现有视频片段进行场景编辑、换脸和唇形同步配音
• 🧑‍🎤 口播人物与虚拟形象 - 保存可重复使用的人脸身份，制作口播虚拟形象视频，以及适用于 Shorts / TikTok 的竖屏 AI 视频博客
• 🎵 音乐与音频 - ElevenLabs Music、ACE-Step、Stable Audio、TTS 旁白（包括克隆声音）
• 🎨 工作室模板 - 照片蒙太奇短视频、复古旅行海报、用你的脸复刻病毒式流行趋势
• 💬 300+ 聊天模型 - Claude（Sonnet / Opus）、GPT-5、Gemini 3、DeepSeek、Sonar 等，统一从一个余额扣费

该服务运行于 https://mcp.avots.ai/，并通过 Streamable HTTP 支持 MCP 2025-06-18 规范。工具按调用次数从你的 avots 余额中扣费（与网页应用或 Telegram 机器人显示的余额相同）。

快速开始

1. 在 avots.ai 注册，并在 Settings → Integrations 创建 MCP 密钥（格式类似 av_mcp_<48hex>）。
2. 从下表选择客户端，并按照对应指南操作。
3. 试用 - 让客户端*“生成一张雪林中的狐狸图片”*，看看令牌如何被扣除。

客户端	指南	身份验证方式
Claude.ai web	docs/claude-web.md	OAuth - 粘贴 URL，点击 Connect 并登录（无需复制粘贴令牌）
Claude Desktop	docs/claude-desktop.md	通过 mcp-remote 使用 Bearer 令牌
Claude Code (CLI)	docs/claude-code.md	通过 claude mcp add 使用 Bearer 令牌
Cursor	docs/cursor.md	通过 mcp-remote 使用 Bearer 令牌
Cline	docs/cline.md	通过 mcp-remote 使用 Bearer 令牌
任何其他 MCP 客户端	docs/tools.md - 端点与工具列表	Bearer 请求头 Authorization: Bearer av_mcp_…

可直接粘贴的 mcp.json 片段位于 examples/ 下。

服务中包含的内容

共 19 个工具，详见 docs/tools.md：

工具	费用	功能
check_balance	免费	当前代币、订阅等级和完整价格目录。
list_models	免费	所有已启用模型及每次调用的费用（可按 chat、image、video、audio 筛选）。
list_avatars	免费	用户已保存、可重复使用的人脸身份。
list_trends	免费	avots Studio 的热门模板目录（换脸视频、广告、动画）。
check_job	免费	按 job_id 查询任意异步任务。
chat	约 10-1000 ⚡	向任意聊天模型发送提示词。可用于委托 GPT、DeepSeek、Sonar 等模型处理任务。
generate_image	约 200-500 ⚡	同步生成图像，也可编辑照片（image_urls）。Recraft 可输出原生矢量 SVG（format: "svg"，2x）。
generate_video	约 200-5000 ⚡	异步生成视频，需两步确认；支持 i2v、多照片角色参考和动作参考片段。
face_swap_video	约 500-2000 ⚡	将现有视频中的人脸替换为照片（或已保存的头像）。需两步确认。
edit_video	约 450 ⚡/秒	根据文本提示词编辑现有片段；保留人物、动作和原始音频。需两步确认。
lipsync_video	约 300-600 ⚡	为现有口播视频重新配音：使用新文本（TTS）或现成音轨。需两步确认。
create_avatar	免费 / 约 200-500 ⚡	从照片（免费）保存可重复使用的人脸身份，或根据描述生成。
generate_talking_avatar	约 600-2500 ⚡	让肖像说出指定文本：TTS + 唇形同步，提供高质量/快速档位。需两步确认。
generate_vlog	预览显示价格	生成竖屏 AI 网红短片，适用于 Shorts / TikTok：服务会根据主题撰写台词。需两步确认。
generate_audio	约 50-800 ⚡	生成音乐（ElevenLabs Music、ACE-Step、Stable Audio）或 TTS 旁白，包括克隆音色。异步。
create_montage	约 200 ⚡	用 4-25 张照片制作幻灯片短片：Ken Burns 效果 + 交叉淡入淡出 + 音乐。
create_travel_poster	约 200-500 ⚡	人脸照片 → 任意国家的复古旅行海报。同步执行。
recreate_trend	按趋势计费	将用户的人脸放入 list_trends 中的热门模板。
create_calendar_event	约 5 ⚡	自然语言 → 在关联的 Apple/Google 日历中创建事件（或下载 .ics 文件）。

关于两步视频流程。 视频是费用最高的工具。为避免意外支出，首次调用 generate_video 时会返回预览卡片（不会提交任务，也不会预留费用）。客户端（例如 Claude）会展示费用和其他备选模型及其价格，并询问用户。用户确认后，客户端会使用选定的 model 和 confirmed: true 再次调用，之后才会提交任务。如果提交出错，服务会返回相同的备选方案卡片，不会悄悄切换到更贵的模型。

可以构建什么

以下是一些实际用途。每个工作流都通过一个连接和同一账户余额串联两个或更多工具。

• 一句提示词生成社交广告创意 — 主视觉图片、动画版本、背景音乐。
• 产品照片多角度套图 — 输入一张产品照片，生成四个角度和一段旋转展示视频。
• 从分镜脚本到动态分镜 — 将四个由脚本驱动的画面制作成一段 12 秒的粗剪视频。
• 竖屏 Reels / Shorts 生产线 — 生成 9:16 短片和匹配的 15 秒背景音乐，每条视频都可重复制作。
• 播客封面图 + 节目说明 — 生成四种封面方案，并为每种方案撰写节目介绍。
• 委托其他模型提供第二意见 — 将棘手问题交给不同技术路线的模型，并比较结果。
• 本地化品牌素材 — 为不同市场提供翻译文案和适配当地市场的视觉内容。

每个工作流都整理成了可运行脚本，包含确切的提示词、工具调用顺序、模型选择和费用，详见 docs/recipes.md。

费用从单张图片约 200⚡ 到 10 秒 1080p Kling Pro 视频片段约 5000⚡ 不等。随时运行 list_models（免费）查看实时的每次调用价格。

账单

所有工具调用的费用都从你的 avots 余额中扣除，与 Web 应用和 Telegram 机器人相同。没有单独计量。每日 USD 上限（在 Settings 中设置）和每个密钥的速率限制均适用。

有关代币包和订阅，请参阅 pricing.avots.ai。

故障排除

常见的跨客户端问题（401 错误、每日上限、两步视频流程、图像渲染、npx PATH 注意事项）汇总在 docs/troubleshooting.md 中。有关特定客户端的设置，请参阅上表中链接的对应客户端指南。

问题与反馈

你可以在此处提交问题，或发送邮件至 [email protected]。如有平台相关问题（账单、模型、Web 应用），Telegram 机器人 @AvotsAIbot 是最快的联系渠道。

许可证

MIT - 欢迎分叉本文档、示例以及此处的任何其他内容。