motion-tools

Mographr MCP Server

通过 AI 助手渲染真实的动态图形叠加层——动画字幕条、标题、标注——并获取成品 MP4。免费、匿名，无需 API 密钥。

Endpoint   https://mcp.mographr.com/mcp
Transport  Streamable HTTP (stateless, JSON responses)
Auth       None
Cost       Free — watermarked MP4

完整文档：https://www.mographr.com/mcp · 机器可读文档：/mcp.md

---

这是什么——以及它不是什么

这不是文生视频模型。它不会凭空生成视频素材。

它会将你的文本、你的配色方案和你选择的设计应用于一小套手工制作的动态图形模板，并返回可叠加到你自己视频上的真实 MP4。

这一区别正是关键。让扩散模型生成“一条写着 Dr. Maya Chen 的字幕条”，它生成的东西看起来像字幕条，却会把名字拼错。而这里渲染的是真实字体中的真实文本，配合真实的关键帧动画——在 1080p 下清晰可读，每次运行结果都完全一致，放心交付给客户。

	Mographr MCP	文生视频 MCP 服务
输出	精心设计的叠加层，文本准确	生成的视频素材，文本近似
确定性	相同输入 → 相同文件	每次结果都不同
字体排印	真实字体、真实字距调整	幻觉生成的字形
身份验证	无	账号 + 点数
用途	叠加到你的视频素材上	独立片段

---

安装

Claude Code

claude mcp add --transport http mographr https://mcp.mographr.com/mcp

Claude Desktop

设置 → 连接器 → 添加自定义连接器 → https://mcp.mographr.com/mcp

不包含此界面的旧版本，可在 claude_desktop_config.json 中配置：

{
  "mcpServers": {
    "mographr": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.mographr.com/mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json，或项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "mographr": { "type": "http", "url": "https://mcp.mographr.com/mcp" }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "mographr": { "type": "http", "url": "https://mcp.mographr.com/mcp" }
  }
}

其他客户端

直接使用 HTTP POST——无需 SDK：

curl -sS https://mcp.mographr.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

注意：Accept 标头必须同时列出 application/json 和 text/event-stream。否则，Streamable HTTP 传输会拒绝请求。几乎所有手动编写的客户端都会在这里遇到问题。

---

工具

工具	功能
list_motion_tools	工具目录。无需参数。从这里开始。
get_motion_tool	查看单个工具的架构：包含最大长度和示例的字段键、设计变体（每种变体都有自己的画布——有些为竖屏 9:16）、配色方案，以及可直接复制的调用示例。
render_motion_tool	将渲染任务加入队列，并立即返回 renderId。使用相同参数重复调用会返回缓存结果，而不会重新渲染。
get_motion_render	轮询 renderId，直到 status 为 completed，然后读取 downloadUrl。

示例

// 1. what is available
{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"list_motion_tools","arguments":{}}}

// 2. render one
{"jsonrpc":"2.0","id":2,"method":"tools/call",
 "params":{"name":"render_motion_tool","arguments":{
   "slug":"lower-thirds",
   "fields":{"title":"Dr. Maya Chen","subtitle":"Marine Biologist"}}}}
// → { "renderId": "…", "status": "queued", "etaSeconds": 68 }

// 3. poll until completed
{"jsonrpc":"2.0","id":3,"method":"tools/call",
 "params":{"name":"get_motion_render","arguments":{"renderId":"…"}}}
// → { "status": "completed", "downloadUrl": "https://…/tool-….mp4" }

在 CPU 队列上，渲染大约需要 30–70 秒。

---

限制

• 每个 IP 每小时约可渲染 8 次，所有 MCP 调用方最多可同时排队 6 个任务。
• 达到限制时，不会返回错误响应。工具会返回正常结果，其中包含 status: "rate_limited"、需要等待的秒数，以及交互页面的链接；该页面没有限制。
• 免费渲染会带有小型 mographr.com 水印。
• 图片上传（头像）仅在交互页面上可用，MCP 不支持。
• Mographr 工作室中的付费导出始终优先使用渲染队列，因此免费流量不会拖慢付费客户，也不会被饿死，只会排队等待。

---

说明

• **无状态。**无需会话、会话 ID 标头，也无需清理任何内容。每个 POST 都彼此独立，因此重新部署绝不会导致连接悬空。端点上的 GET 和 DELETE 按设计会返回 405。CORS 为开放状态。
• **旧版主机。**也可通过 https://bff.mographr.com/mcp 访问此端点——这是同一 MCP 服务，且会继续可用。
• 也支持 REST。GET https://bff.mographr.com/tools 会列出工具目录，POST /tools/<slug>/render 会启动渲染。REST 还支持图片上传，MCP 则不支持。

链接

• 文档
• 带交互式编辑器的免费工具
• 免费的动态图形模板
• 定价
• 面向 Agent 的站点指南 (llms.txt)

收录平台

• 官方 MCP 注册表 — com.mographr/motion-tools
• Smithery

许可证

本仓库中的文档采用 MIT 许可证。该服务由 Mographr 根据其使用条款运营；渲染输出受这些条款约束。