DemoStudio

@demostudio/mcp-server

适用于 DemoStudio 的 MCP 服务——让任何兼容 MCP 的 AI 助手（Claude Code、Cursor、Windsurf 等）都能直接通过对话生成短视频广告。

功能

• generate_video — 将文字简报转为成片，适用于 Instagram Reel / TikTok / YouTube Short
• get_video_status — 查看制作进度并获取导出视频的 URL
• list_capabilities — 展示全部 5 种场景类型和 17 个 Remotion 模板
• create_schedule — 设置 Agent，按固定周期自动生成视频

要求

• Node.js 18+
• DemoStudio API 密钥——在 demostudio.xyz/settings 获取

安装

Claude Code

claude mcp add --transport stdio \
  --env DEMOSTUDIO_API_KEY=your_api_key_here \
  demostudio \
  -- npx -y @demostudio/mcp-server

Cursor / Windsurf

添加到 MCP 配置文件（~/.cursor/mcp.json 或 ~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "demostudio": {
      "command": "npx",
      "args": ["-y", "@demostudio/mcp-server"],
      "env": {
        "DEMOSTUDIO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "demostudio": {
      "command": "npx",
      "args": ["-y", "@demostudio/mcp-server"],
      "env": {
        "DEMOSTUDIO_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用示例

安装后，只需自然地与 AI 助手交谈：

Generate a 30-second Instagram Reel for my SaaS product.
It's an AI inbox tool called Clearbox. Target: busy founders.
Tone: confident, direct. End with "Try it free at getclearbox.com".
Music: uplifting. Add subtitles.

What Remotion templates does DemoStudio support?

Check the status of project abc-123.

Set up a weekly automated video for my brand.
Product: Kova — project management for remote teams.
URL: https://getkova.com. Calm music. Run every Monday.

工具参考

generate_video

Parameter	Type	Required	Description
prompt	string	✓	完整创意简报——产品、受众、风格、场景、CTA
product_url	string		用于抓取品牌颜色、徽标和描述的 URL
music_mood	hype | uplifting | calm		背景音乐风格
subtitles	boolean		为旁白场景添加内嵌字幕（默认：true）
voice_gender	male | female		首选旁白性别

返回项目 URL，可用于预览和导出视频。

get_video_status

Parameter	Type	Required	Description
project_id	string	✓	来自 generate_video 的项目 UUID

list_capabilities

不需要参数。返回全部 17 个 Remotion 模板及其描述。

create_schedule

Parameter	Type	Required	Description
frequency	daily | weekly | biweekly | monthly	✓	生成频率
run_day_of_week	number (0–6)		星期几（0=周日）。适用于 weekly/biweekly/monthly
brand_description	string		添加到知识库的文字简报
product_url	string		用于抓取并添加到知识库的 URL
music_mood	hype | uplifting | calm		自动运行时使用的默认音乐风格

定价

DemoStudio 按积分计费。新账户可获得 500 个免费积分（足以制作约 1 支完整视频）。 活跃账户每月可获得最多 500 个奖励积分。

• 场景生成：10 个积分
• 视频导出：400 个积分
• 自动运行：约 700 个积分

查看定价 →

许可证

MIT

---

维护者指南 — 发布更新

1. 在 src/index.ts 中修改代码

2. 提升版本号

npm version patch   # 0.1.2 → 0.1.3  (bug fix / small change)
npm version minor   # 0.1.2 → 0.2.0  (new tool or renamed tool)
npm version major   # 0.1.2 → 1.0.0  (breaking change)

3. 发布到 npm

npm publish --access public

发布前，prepublishOnly 脚本会自动运行 tsc。

4. 更新 server.json — 提升两个版本字段

{
  "version": "0.1.3",          ← top-level version
  "packages": [{
    "version": "0.1.3"         ← must match npm version
  }]
}

5. 重新验证身份并发布到 MCP registry

registry JWT 约 1 小时后过期。发布前务必重新登录。

# Download the publisher binary (if not already on PATH)
curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher

# Login via GitHub device flow
./mcp-publisher login github
# → go to https://github.com/login/device and enter the printed code

# Publish
./mcp-publisher publish server.json

6. 推送到 GitHub

git add -A
git commit -m "chore: bump to vX.Y.Z — <what changed>"
git push origin main

说明

• server.json 的 $schema URL 带有版本号——只有在 registry 发布了新的 schema 版本时才更新（查看 https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md）
• .mcpregistry_* 文件已被 gitignore 忽略——这些文件包含身份验证令牌，绝不能提交
• npm 令牌保存在 ~/.npmrc 中——如果令牌过期，请重新运行 npm set //registry.npmjs.org/:_authToken <token>