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 — エージェントが定期的なスケジュールで動画を自動生成するよう設定します

要件

• 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

パラメーター	型	必須	説明
prompt	string	✓	クリエイティブブリーフ全体 — 製品、対象ユーザー、トーン、シーン、CTA
product_url	string		ブランドカラー、ロゴ、説明を取得するためにクロールする URL
music_mood	hype | uplifting | calm		BGM の雰囲気
subtitles	boolean		ナレーションのシーンに字幕を焼き付けます（デフォルト：true）
voice_gender	male | female		希望するナレーションの性別

動画をプレビューしてエクスポートできるプロジェクト URL を返します。

get_video_status

パラメーター	型	必須	説明
project_id	string	✓	generate_video が返すプロジェクトの UUID

list_capabilities

パラメーターはありません。説明付きの Remotion テンプレートを 17 種類すべて返します。

create_schedule

パラメーター	型	必須	説明
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 レジストリに公開します

レジストリの 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 にはバージョンが含まれています。レジストリで新しいスキーマバージョンが公開された場合にのみ更新してください（https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md を確認してください）
• .mcpregistry_* ファイルは gitignore 対象です。認証トークンが含まれているため、絶対にコミットしないでください
• npm トークンは ~/.npmrc に保存されています。期限切れになった場合は、npm set //registry.npmjs.org/:_authToken <token> を再実行してください