Tanvo

Tanvo MCP

这是 Tanvo 的 MCP 服务。Tanvo 是一款 AI 图像、视频和音乐工作室。你可以向助手提出“根据这张照片生成一幅我家猫的文艺复兴风格肖像”“把这张自拍变成盒装动作人偶”“生成一段展示这款产品旋转的 10 秒视频”或“为 Sam 创作一首生日歌”等要求，它就会在 Tanvo 上运行任务并把文件交给你。

可用于 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Cline、Codex、Gemini CLI 以及其他任何 MCP 客户端。无需 API 密钥即可试用：免费套餐包含内置图像引擎。

功能

• 80 款现成应用，提供 350 多种预设效果。 宠物肖像、手办、旧照片修复、AI 宝宝、产品照片、服装试穿、热门视频（酒店大堂双人舞、哭泣滤镜、舞蹈）、生日歌曲和情歌。每种效果都配有经过调校的提示词和实际输出示例，让你知道会得到什么。
• 图像：支持 Nano Banana 2 / Pro、Seedream 5、GPT Image 2.5、Qwen Image、Grok Imagine 和免费内置引擎；可通过文本生成图像、编辑图像和合成多张照片。
• 视频：支持 Veo 3.1、Kling 3.0、Seedance 2.5、Wan、Minimax 等；可通过文本或图像生成视频，设置起始帧和结束帧，并生成原生音效。
• 歌曲：支持 Suno V6；每次运行生成两个版本，每个版本都包含 MP3、封面图、标题和歌词。
• 自动上传本地照片，并可将结果直接保存到文件夹中。

工具

工具	功能
find_apps	根据用户需求搜索应用（例如“皇家宠物肖像”“修复旧照片”）
get_app	查看应用的输入项和效果，以及示例输出、提示词和费用
generate_from_app	使用应用效果处理用户的照片
generate_image	通过文本生成图像，或编辑／合成照片
generate_video	通过文本或图像生成视频（返回一个 ID；视频生成需要几分钟）
generate_music	创作歌曲：描述歌曲、提供歌词，或选择纯音乐
get_generation	查看运行状态和输出；可等待并保存文件
list_models	查看所有模型、选项和所需积分
account	查看免费套餐或账户信息，以及剩余积分
open_in_tanvo	打开应用、效果或工作室的链接，内容已准备就绪

安装

服务通过 npx 运行，因此无需预先安装（需要 Node 20+）。

Claude Code

claude mcp add tanvo -- npx -y tanvo-mcp

添加 -e TANVO_API_KEY=sk_... 即可使用你的账户运行。

Claude Desktop、Cursor、Windsurf、Cline、VS Code（客户端 MCP 配置中的 mcpServers 区块）

{
  "mcpServers": {
    "tanvo": {
      "command": "npx",
      "args": ["-y", "tanvo-mcp"],
      "env": { "TANVO_API_KEY": "sk_..." }
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/tanvoai/tanvo-mcp

Codex（~/.codex/config.toml）

[mcp_servers.tanvo]
command = "npx"
args = ["-y", "tanvo-mcp"]
env = { TANVO_API_KEY = "sk_..." }

自行安装服务的 AI Agent（Cline 等）可以参考 llms-install.md。

免费套餐和 API 密钥

不提供密钥时，服务会使用 Tanvo 的匿名免费套餐：内置图像引擎（studio-image-v1），生成的图像带水印，每台设备每天可生成少量图像。其他所有功能（使用高级模型的应用、视频、歌曲）都需要密钥。需要密钥时，服务会返回一个链接，在浏览器中打开同一应用或提示词；新账户注册后即可获得免费积分。

你可以在设置 → API 密钥中创建密钥。使用密钥时，任务将在你自己的账户上运行：使用与网站相同的模型、价格和套餐，且每次运行都会记录在你的历史记录中。get_app / list_models 会显示每次运行的价格，失败的运行会自动退款。

变量	含义
TANVO_API_KEY	你的 API 密钥（可选）
TANVO_OUTPUT_DIR	将每个结果保存到此文件夹（可选；每次调用也可以传入 save_to）
TANVO_BASE_URL	其他部署地址，例如本地构建版本（默认值为 https://tanvo.ai）
TANVO_ANON_ID	固定免费套餐 ID，不使用存储在 ~/.config/tanvo-mcp/anon-id 中的 ID

示例

把我的狗做成文艺复兴时期的油画风格。~/Pictures/rex.jpg

find_apps → get_app ai-pet-portrait-generator → 使用 renaissance 风格和这张照片调用 generate_from_app。

为我姐姐 Ana 写一首生日歌，她喜欢冲浪和糟糕的双关语。保存到 ~/Music。

在描述模式下调用 generate_music，并设置 save_to: "~/Music"。

将这张产品照片制作成缓慢旋转 360° 的动画，比例为 9:16。

find_apps "product spin" → generate_from_app product-spin，然后反复调用 get_generation，直到任务完成。

隐私

你提供的提示词和照片会发送至 tanvo.ai 以执行任务，并受隐私政策约束。所有内容在处理前都会经过审核。除匿名免费套餐 ID 外，服务不会存储任何内容。

开发

npm install
npm run build
TANVO_BASE_URL=http://localhost:3210 node dist/index.js

文档：tanvo.ai/developers/mcp · API 参考：tanvo.ai/developers/api · OpenAPI：tanvo.ai/openapi.yaml

Tanvo 的其他项目

• tanvo-python：pip install tanvo
• tanvo-js：npm install @tanvoai/sdk

许可证

MIT