Back to Directory/Media & Images

io.github.hanshs474/seedance-prompts-mcp

Search, audit and compose AI video prompts — 150 of them, each rendered into a real video

Media & ImagesPythonv1.0.1

Seedance Prompts MCP

150 AI video prompts that were each actually rendered into a video. Search them, read the full text in English and Japanese, watch the clip the prompt produced, audit your own draft against what the rendered prompts specify, or compose a new one — all from your MCP client.

Most "prompt library" packages ship prompts nobody ran, so you find out what a prompt does only after you spend a generation on it. Here the clip came first: every entry links to the video that this exact text produced, and the audit tool measures your draft against all 150 of them rather than against someone's opinion of good prompting.

Add it to your client with the two lines below, then ask it to find you a prompt.

Install

Node 18+. No dependencies, no API key, no network access at runtime — the prompt set is bundled.

{
  "mcpServers": {
    "seedance-prompts": {
      "command": "npx",
      "args": ["-y", "seedance-prompts-mcp"]
    }
  }
}

Claude Desktop: claude_desktop_config.json. Cursor: .cursor/mcp.json. Any other stdio MCP client takes the same two lines.

Tools

ToolWhat it does
search_promptsFree-text search over 150 prompts (English or Japanese), filter by category or by whether the prompt expects a reference image.
get_promptFull English + Japanese prompt text, the example video URL, and where to run it.
list_categoriesThe ten categories and how many prompts each holds.
check_promptAudits a draft against the seven elements measured across all 150 rendered prompts — style, scene, subject, camera, lighting, sound, timeline. Names what is missing, why it matters, and hands you a real prompt to copy from.
build_promptComposes those seven elements plus timeline beats into the bracket format the rendered prompts use, and tells you which fields you left to the model.

Why the audit is worth running

The seven elements are not a style guide someone invented — they are counted over the bundled set at load time. Across the 150 rendered prompts, camera work is specified in half of them and audio in far fewer: those two are where drafts most often leave the result to chance. Seedance 2 generates audio together with the video, so an unspecified soundtrack is a decision you handed over rather than a field you skipped.

check_prompt("A woman turns around in a neon alley at night")
→ 2/7 · missing: camera work, lighting, sound, timeline …
  each with the reason it matters and a rendered prompt to copy the phrasing from

Example

search_prompts({ query: "product commercial", limit: 3 })
get_prompt({ slug: "perfume-product-advertisement-generation-prompt-for-seedance-2-0" })
→ prompt_en, prompt_ja, example_video (mp4), source

Where the prompts come from

They are the public prompt library of Emaki, a Japanese AI video site running Seedance 2 and Seedance 2.5. Each entry there has the prompt, the settings and the resulting clip. 32 of the 150 are image-to-video prompts that show how to address multiple reference images (@Image1, @Image2) — the part that is hardest to guess.

Pick a prompt and run it in the browser: text to video · image to video · Seedance 2.5 (up to 30 seconds with audio in one pass).

License

MIT. The prompt texts are published by Emaki for reuse; the example videos stay on Emaki's CDN.

Python build

The same server for uvx users lives on PyPI as seedance-prompts-mcp — same five tools, same bundled prompts, standard library only. Source is in python/; the prompt data is copied from src/prompts.json at publish time so the two builds cannot drift apart.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y seedance-prompts-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-hanshs474-seedance-prompts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "seedance-prompts-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

seedance-prompts-mcpnpm

Compatible MCP Clients

io.github.hanshs474/seedance-prompts-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More