AI Video Atlas

AI Video Atlas MCP 服务

为你的 AI Agent 配备一位视频导演。这是 AI Video Atlas 背后的开源 MCP 服务（和 REST API）。它让 Claude、ChatGPT、Cursor、Gemini、Grok Bot 或任何 MCP 客户端都能根据 Atlas 数据规划 AI 视频镜头、选择模型、查找有来源的提示词，并按供应商标注的每秒价格估算片段费用。

• 在线端点： https://mcp.aivideoatlas.com/mcp（可流式传输的 HTTP，无需身份验证，免费）
• REST API： https://mcp.aivideoatlas.com/v1/<tool>。OpenAPI 规范位于 https://mcp.aivideoatlas.com/openapi.json。
• Agent 指南： https://aivideoatlas.com/agents/

它是只读且确定性的：服务端不会进行 AI 生成，所有回答均基于 Atlas 的来源数据，并附有指向原作者和供应商页面的链接。

连接

Claude（网页和桌面端）： 打开 claude.ai → Settings → Connectors，点击 Add custom connector，将其命名为 AI Video Atlas，然后粘贴 https://mcp.aivideoatlas.com/mcp。无需登录。对于 Team 和 Enterprise 方案，所有者可能需要先添加连接器。 Claude Code：

claude mcp add --transport http ai-video-atlas https://mcp.aivideoatlas.com/mcp

ChatGPT： 自定义 MCP 连接器需要启用 developer mode，这是付费方案（Pro、Business、Enterprise、Edu）的测试版功能。Free 方案无法使用。打开 Settings → Apps & Connectors → Advanced settings 并启用 Developer mode。然后点击 Create，将其命名为 AI Video Atlas，粘贴 URL，并将身份验证设为 No authentication。 想要改为构建自定义 GPT？前往 Configure → Actions → Import from URL，并使用 https://mcp.aivideoatlas.com/openapi.json。

Cursor： 使用 https://aivideoatlas.com/agents/ 上的一键式“Add to Cursor”按钮，或将以下内容添加到 ~/.cursor/mcp.json：

{"mcpServers":{"ai-video-atlas":{"url":"https://mcp.aivideoatlas.com/mcp"}}}

Gemini： Gemini CLI（免费）：

gemini mcp add --transport http ai-video-atlas https://mcp.aivideoatlas.com/mcp

在 Gemini 应用中，自定义连接应用仅限美国个人 Google 账号上的 Gemini Spark 用户使用（须年满 18 岁）。如果你可以使用该功能，请使用上方的 URL 添加自定义应用。Gems 无法连接外部工具。

Grok Bot： 将以下内容粘贴到 Grok Bot 聊天中：

Add this MCP server: name aivideoatlas, URL https://mcp.aivideoatlas.com/mcp (no key needed).

Grok Bot 会在添加前向你确认，之后你就可以从下一条消息开始使用这些工具。

任何 MCP 客户端 / API： 使用上方的 URL（可流式传输的 HTTP，无需身份验证）。如需使用普通 HTTP：

curl "https://mcp.aivideoatlas.com/v1/find_shot?query=drone+shot&limit=3"

VS Code、Windsurf 和其他 MCP 客户端使用相同的 URL。

工具

工具	功能
plan_shots	根据普通描述规划多镜头视频：将描述拆分为多个节拍，并为每个节拍选择有来源的镜头、模型和提示词，并估算费用。确定性输出，仅基于 Atlas 数据。
find_shot	搜索有来源的 AI 视频镜头库（创作者发布的真实提示词，包含所用模型、预估费用以及原始内容链接）。
best_prompt	获取与镜头最匹配的完整来源提示词；可指定目标模型，并附上创作者署名和来源。
recommend_model	根据证据为镜头推荐模型：显示每个模型所用的来源镜头数、供应商标注的最低每秒价格，以及预估总费用。
get_prices	获取供应商标注的每秒价格，附来源 URL 和核查日期。可按系列或托管方筛选。除非明确要求，否则不包含已停用的条目。
get_workflow	按任务类型分组的操作指南、工具和模型指南（唇形同步、升采样、角色一致性等）。
get_guide	按模型提供提示词指导（结构、镜头、模式、一致性、音频、应避免的内容和限制），来源包括供应商文档和经过验证的 Atlas 示例。
whats_new	查看最近 N 天新增的最新镜头和指南。

该服务还提供 MCP 资源（例如 atlas://guides/<model>）和服务端指令，告知 Agent 何时使用各项工具。

速率限制

公共实例免费且无需密钥。每个客户端每分钟允许约 60 次请求（按 IPv4 地址或 IPv6 /48 网段计算），由 Durable Object 执行限制。备用边缘规则也会生效。超过限制时，将收到带有 retry-after 的 HTTP 429 响应。

隐私

• 无需账号、密钥或 Cookie。
• 绝不存储或记录 IP 地址。 IP 地址仅在内存中用于实施速率限制。
• Workers 调用日志已关闭。唯一的日志记录是一条匿名的 atlas_query 事件：工具名称、查询文本（转为小写并截断）、参数名称、结果数量、延迟时间，以及客户端发送的客户端名称。记录这些信息是为了了解哪些工具和主题有用。
• 每日汇总计数（会话数、各工具的调用次数、MCP 与 REST 的调用次数、客户端名称）保存在 Durable Object 中，并发布于 https://mcp.aivideoatlas.com/stats/daily。仅包含计数：不含 IP 地址或查询文本。
• 请勿在查询中填写个人信息。
• 完整政策：https://aivideoatlas.com/privacy/

运行自己的副本

npm install
npm run build            # downloads the public data export from https://aivideoatlas.com/agent-data.json and inlines it
npx wrangler dev         # local
npx wrangler deploy      # needs your own Cloudflare account

npm run build 会生成 dist/worker.mjs。如果要从本地导出文件构建，请运行 node scripts/build.mjs --data=path/to/agent-data.json，或者将文件放在 data/agent-data.json（已加入 gitignore）。

在 wrangler.toml 中设置 account_id（或使用 CLOUDFLARE_ACCOUNT_ID），并可选择设置自己的自定义域名路由。Durable Object 绑定 LIMITER → RateLimiter（由 SQLite 提供支持，免费计划可用）已声明。无需任何密钥。

数据与许可

代码采用 MIT 许可（见 LICENSE）。数据不在此代码库中：它来自 AI Video Atlas 的公开导出，其中每个条目都链接到原始创作者和供应商来源，并注明出处。展示结果时请保留这些出处信息。

注册表

server.json 是官方 MCP Registry（com.aivideoatlas/atlas）的入口。

联系方式：[email protected]