{"_id":"@aeromechanic/volcengine-video-mcp","_rev":"6-49c3701ee015619921afb1c15472eb63","name":"@aeromechanic/volcengine-video-mcp","dist-tags":{"latest":"1.5.5"},"versions":{"1.1.0":{"name":"@aeromechanic/volcengine-video-mcp","version":"1.1.0","_id":"@aeromechanic/volcengine-video-mcp@1.1.0","maintainers":[{"name":"aeromechanic","email":"aero.mech.000@gmail.com"}],"bin":{"volc-vid":"build/index.js"},"dist":{"shasum":"a611c0dbf78d6434de3512647b154b946230da40","tarball":"https://registry.npmjs.org/@aeromechanic/volcengine-video-mcp/-/volcengine-video-mcp-1.1.0.tgz","fileCount":5,"integrity":"sha512-rqT40/22uyjGUOksQ4wlClg/E+V77YlJKgvpMGnn/n8x0QoN0JmZCwPK9fRs8eyZ5RXhMNusfRU/0f1gbN855Q==","signatures":[{"sig":"MEUCIQD0yJk8B1agCzeDgtChgneFw2v1gzpyPdr+oS0GB4i+VwIgFsIOMMarI2nin0ciY00gK2t6PdEYNBPxBPpOM4CttI4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7034},"main":"build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"179fb3bf3f3951988fbf704eba683686858939d2","scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build","install-skill":"mkdir -p .claude/skills/volcengine-video && cp SKILL.md .claude/skills/volcengine-video/SKILL.md"},"_npmUser":{"name":"aeromechanic","email":"aero.mech.000@gmail.com"},"_npmVersion":"10.8.2","description":"Volcengine Video Generation MCP for Claude Code","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/volcengine-video-mcp_1.1.0_1770827973232_0.7746977730893336","host":"s3://npm-registry-packages-npm-production"}},"1.5.0":{"name":"@aeromechanic/volcengine-video-mcp","version":"1.5.0","_id":"@aeromechanic/volcengine-video-mcp@1.5.0","maintainers":[{"name":"aeromechanic","email":"aero.mech.000@gmail.com"}],"bin":{"volc-vid":"build/index.js"},"dist":{"shasum":"ae6772cf93e01759364ae41749ef1cb743554744","tarball":"https://registry.npmjs.org/@aeromechanic/volcengine-video-mcp/-/volcengine-video-mcp-1.5.0.tgz","fileCount":5,"integrity":"sha512-Uufmvp9g2bdBbZZcfKUUyoDHuH/jyQ1ReAv7jM0RSfeSlW4aAHLGGvKXZOdxdCmlmoC/XqzREhKsNmzYTM+PEQ==","signatures":[{"sig":"MEQCIAP7IMEL6yDJugxF/kRMgXWTbBYUUoGAGXv5sXsQ1XmLAiBhQI+6bHvs+AaSL49dWy/657lboFKveNtPSpql0YzUbA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8770},"main":"build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"9ff776ebcc958a078f0264c90dc84207680d2e94","scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build"},"_npmUser":{"name":"aeromechanic","email":"aero.mech.000@gmail.com"},"_npmVersion":"10.8.2","description":"Volcengine Video Generation MCP for Claude Code","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/volcengine-video-mcp_1.5.0_1770829287193_0.6286811415375402","host":"s3://npm-registry-packages-npm-production"}},"1.5.2":{"name":"@aeromechanic/volcengine-video-mcp","version":"1.5.2","_id":"@aeromechanic/volcengine-video-mcp@1.5.2","maintainers":[{"name":"aeromechanic","email":"aero.mech.000@gmail.com"}],"bin":{"volc-vid":"build/index.js"},"dist":{"shasum":"da22db0318b643cce2d79cee23cdbc1bda299d6a","tarball":"https://registry.npmjs.org/@aeromechanic/volcengine-video-mcp/-/volcengine-video-mcp-1.5.2.tgz","fileCount":5,"integrity":"sha512-2Kp4ayNwsLX7PXCTQ4UQ7GVTacbLL2QpNubPWv1yCG4Ybxn+8VJPb8Pkd8+0+snfC2jqj3BHCDuLaE6DRDleUg==","signatures":[{"sig":"MEUCIQCqCC5zfyIgDz/SW46hsdh+Y6DUJyxFp7jy8ZbIRlnRXAIgf3Hgoh85TSVnwiUbYG8p0ji78SG7RGy5+x8v6c+jVZ0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8771},"main":"build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"9ff776ebcc958a078f0264c90dc84207680d2e94","scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build"},"_npmUser":{"name":"aeromechanic","email":"aero.mech.000@gmail.com"},"_npmVersion":"10.8.2","description":"Volcengine Video Generation MCP for Claude Code","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/volcengine-video-mcp_1.5.2_1770829422922_0.31059924936434613","host":"s3://npm-registry-packages-npm-production"}},"1.5.3":{"name":"@aeromechanic/volcengine-video-mcp","version":"1.5.3","_id":"@aeromechanic/volcengine-video-mcp@1.5.3","maintainers":[{"name":"aeromechanic","email":"aero.mech.000@gmail.com"}],"bin":{"volc-vid":"build/index.js"},"dist":{"shasum":"1d919c656c94f5aab5af86bbe5191ce368b35d5f","tarball":"https://registry.npmjs.org/@aeromechanic/volcengine-video-mcp/-/volcengine-video-mcp-1.5.3.tgz","fileCount":5,"integrity":"sha512-KdhxdBa7erDcY+0qz751rE7FK7nikgUxGRVB8+c9RxQu5CJJtJa0RbSsAeNAPdusr0bR+bIj/4G0PlqcZFca3w==","signatures":[{"sig":"MEUCICrWv36NSu6wxq4PojEG6OPn/z0mhyOwhiQjBqbLxoIrAiEA6jv/1ys0SDNpO7w5ckjh2IdU5IilqE9WokJTIX+QjVA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10488},"main":"build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"d6df686f3580a64050e3d0632df7d2c2c3195698","scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build"},"_npmUser":{"name":"aeromechanic","email":"aero.mech.000@gmail.com"},"_npmVersion":"10.8.2","description":"Volcengine Video Generation MCP for Claude Code","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/volcengine-video-mcp_1.5.3_1770829726076_0.4408038774815781","host":"s3://npm-registry-packages-npm-production"}},"1.5.4":{"name":"@aeromechanic/volcengine-video-mcp","version":"1.5.4","_id":"@aeromechanic/volcengine-video-mcp@1.5.4","maintainers":[{"name":"aeromechanic","email":"aero.mech.000@gmail.com"}],"bin":{"volc-vid":"build/index.js"},"dist":{"shasum":"21d10468d3339eeacff2f83c86d07cde66c9490a","tarball":"https://registry.npmjs.org/@aeromechanic/volcengine-video-mcp/-/volcengine-video-mcp-1.5.4.tgz","fileCount":5,"integrity":"sha512-HU9F9Nm4tJp+etHDuh6dVPm5Yyu6jd+52mYzeftuUgay+8+BlgVTNh2j8TCbxUsIX72trMgbDl5P/KvH06rQdA==","signatures":[{"sig":"MEUCIDl7w/aftVK6brIsdrnl7zK57gPUAPA6ArFfpBFBRVwIAiEA7HRiv7wttt0zLIfRCiVHAlUDZjlz66NcahNZtlkVBPs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10518},"main":"build/index.js","type":"module","types":"./build/index.d.ts","gitHead":"5786a06c7d074d93217c6677f1f54518ebc8cf8f","scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build"},"_npmUser":{"name":"aeromechanic","email":"aero.mech.000@gmail.com"},"_npmVersion":"10.8.2","description":"Volcengine Video Generation MCP for Claude Code","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/volcengine-video-mcp_1.5.4_1770830069040_0.7135606444048677","host":"s3://npm-registry-packages-npm-production"}},"1.5.5":{"name":"@aeromechanic/volcengine-video-mcp","version":"1.5.5","description":"Volcengine Video Generation MCP for Claude Code","main":"build/index.js","type":"module","bin":{"volc-vid":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.6.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"_id":"@aeromechanic/volcengine-video-mcp@1.5.5","gitHead":"dcefe66c0cc915fc3a7860cd5f1a091cb2146b9a","types":"./build/index.d.ts","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-jBKhYeiFz31Khqw7tuQJs44gwtfzmhmuA4swwIP/uJOj/rWTooyz97arhxyj53anZloRDoq9pFbKAfIGJS0ljA==","shasum":"8fa5ba98cc32bb04d2fdf9e72593baa43d293cca","tarball":"https://registry.npmjs.org/@aeromechanic/volcengine-video-mcp/-/volcengine-video-mcp-1.5.5.tgz","fileCount":5,"unpackedSize":12126,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIG9qvNicTKmlkwDzYo6FafuPlK4xzZMh0ax7nMtdEGO1AiEAxCfCEGbmWa327PiMuLy9Hc3y8/UVMB4q8liRAvB/600="}]},"_npmUser":{"name":"aeromechanic","email":"aero.mech.000@gmail.com"},"directories":{},"maintainers":[{"name":"aeromechanic","email":"aero.mech.000@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/volcengine-video-mcp_1.5.5_1770830491744_0.41383352453604916"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-11T16:39:33.178Z","modified":"2026-02-11T17:21:31.999Z","1.1.0":"2026-02-11T16:39:33.417Z","1.5.0":"2026-02-11T17:01:27.379Z","1.5.2":"2026-02-11T17:03:43.073Z","1.5.3":"2026-02-11T17:08:46.234Z","1.5.4":"2026-02-11T17:14:29.186Z","1.5.5":"2026-02-11T17:21:31.892Z"},"description":"Volcengine Video Generation MCP for Claude Code","maintainers":[{"name":"aeromechanic","email":"aero.mech.000@gmail.com"}],"readme":"# Volcengine Video MCP for Claude Code 🎬\n\nDeveloped by [@aeromechanic](https://github.com/aeromechanic000).  \nA Model Context Protocol (MCP) server that enables **Claude Code** to generate high-fidelity AI videos using Volcengine's **Doubao-Seedance 1.5 Pro** model.\n\n## ✨ Features\n\n- **Text-to-Video**: Generate cinematic clips from natural language descriptions.\n- **Image-to-Video**: Transform static images into dynamic videos using local reference files.\n- **State-of-the-Art Model**: Defaults to `doubao-seedance-1-5-pro-251215` for industry-leading quality.\n\n---\n\n## 🚀 Quick Start\n\n### 1. Install the MCP Server\nAdd the video generation tool to your Claude Code environment:\n```bash\nclaude mcp add volc-vid -- npx -y @aeromechanic/volcengine-video-mcp\n```\n\n### 2. Set Your API Key\n\nSet your VolcEngine API key as an environment variable (add this to your `.zshrc` or `.bashrc` for persistence):\n\n```bash\nexport DOUBAO_API_KEY=\"your_volcengine_api_key_here\"\n\n```\n\n---\n\n## 🛠 Usage Examples\n\nOnce installed, you can simply ask Claude in plain English:\n\n* **Simple Prompt**: *\"Generate a 5s video of a neon-lit cyberpunk street in Tokyo and save it to ./tokyo.mp4\"*\n* **Image Reference**: *\"Animate this character: ./assets/hero.png. Make him walk forward through a portal.\"*\n* **Custom Model**: *\"Use the lite version of Seedance to generate a quick test video of a cat jumping.\"*\n\n---\n\n## 📝 Configuration & Requirements\n\n* **Model Endpoint**: You must have a valid **Endpoint ID** created in the [Volcengine Ark Console](https://www.volcengine.com/product/ark) for the `doubao-seedance-1-5-pro-251215` model.\n* **Environment**: Ensure `DOUBAO_API_KEY` is set before starting your Claude Code session.\n\n> **Tip**: The included `SKILL.md` file contains optional instructions you can add to your Claude Code configuration to help Claude better understand how to use this tool.\n\n## 📂 Project Structure\n\n* `src/index.ts`: The core MCP server logic.\n* `SKILL.md`: (Optional) Procedural instructions for Claude Code to handle video workflows.\n* `package.json`: Project metadata.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! If you have suggestions for new features or find a bug, please open an issue or submit a pull request on the [GitHub repository](https://github.com/aeromechanic000/volcengine-video-mcp).\n\n## 📄 License\n\nMIT © [aeromechanic](https://github.com/aeromechanic000)\n","readmeFilename":"README.md"}