Skip to content
Back to search

capcut-mcp-server

A professional Model Context Protocol (MCP) server for CapCut Pro video editing automation. This server enables AI assistants and applications to create and edit videos programmatically through…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/atx-guy--capcut-mcp-server/badge.svg)](/listings/atx-guy--capcut-mcp-server)

HTML

<a href="/listings/atx-guy--capcut-mcp-server"><img src="/api/listings/atx-guy--capcut-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option 1: Install from npm (once published)

npm install -g capcut-mcp-server

Option 2: Build from Source

# Clone this repository
git clone <your-repo-url>
cd capcut-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Test the server
npm start

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 357 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # CapCut MCP Server
  2. A professional Model Context Protocol (MCP) server for **CapCut Pro** video editing automation. This server enables AI assistants and applications to create and edit videos programmatically through CapCut's powerful editing capabilities.
  3. ## 🎬 Features
  4. - **Complete Video Editing Suite**: Create drafts, add videos, audio, text, images, effects, and more
  5. - **Professional Tools**: 11 specialized tools for video production workflows
  6. - **Type-Safe**: Built with TypeScript for reliability and excellent IDE support
  7. - **Flexible Transport**: Supports both stdio (local) and HTTP (remote) connections
  8. - **Input Validation**: Comprehensive Zod schemas with helpful error messages
  9. - **Dual Output Formats**: JSON for machines, Markdown for humans
  10. ## 📋 Prerequisites
  11. Before using this MCP server, you need to have the **VectCutAPI** (CapCut API server) running:
  12. 1. **Install VectCutAPI**:
  13. ```bash
  14. git clone https://github.com/sun-guannan/VectCutAPI.git
  15. cd VectCutAPI
  16. pip install -r requirements.txt
  17. ```
  18. 2. **Start the API Server**:
  19. ```bash
  20. python capcut_server.py
  21. ```
  22. The server will start on `http://localhost:9001` by default.
  23. ## 🚀 Installation
  24. ### Option 1: Install from npm (once published)
  25. ```bash
  26. npm install -g capcut-mcp-server
  27. ```
  28. ### Option 2: Build from Source
  29. ```bash
  30. # Clone this repository
  31. git clone <your-repo-url>
  32. cd capcut-mcp-server
  33. # Install dependencies
  34. npm install
  35. # Build the project
  36. npm run build
  37. # Test the server
  38. npm start
  39. ```
  40. ## 🔧 Configuration
  41. ### For Claude Desktop
  42. Add to your Claude Desktop config file:
  43. **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
  44. **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
  45. ```json
  46. {
  47. "mcpServers": {
  48. "capcut": {
  49. "command": "node",
  50. "args": ["/absolute/path/to/capcut-mcp-server/dist/index.js"],
  51. "env": {
  52. "CAPCUT_API_URL": "http://localhost:9001"
  53. }
  54. }
  55. }
  56. }
  57. ```
  58. ### For Other MCP Clients
  59. The server supports two transport modes:
  60. #### Stdio Mode (Default - Local Integration)
  61. ```bash
  62. node dist/index.js
  63. ```
  64. #### HTTP Mode (Remote Access)
  65. ```bash
  66. TRANSPORT=http PORT=3000 node dist/index.js
  67. ```
  68. ## 🛠️ Available Tools
  69. ### 1. `capcut_create_draft`
  70. Create a new video editing project with custom dimensions and frame rate.
  71. **Example**:
  72. ```typescript
  73. {
  74. "width": 1920,
  75. "height": 1080,
  76. "fps": 30
  77. }
  78. ```
  79. ### 2. `capcut_add_video`
  80. Add video clips with transitions, speed control, and volume adjustments.
  81. **Example**:
  82. ```typescript
  83. {
  84. "draft_id": "abc123",
  85. "video_url": "https://example.com/video.mp4",
  86. "start": 0,
  87. "end": 10,
  88. "volume": 0.8,
  89. "transition": "fade_in",
  90. "speed": 1.0
  91. }
  92. ```
  93. ### 3. `capcut_add_audio`
  94. Add background music or sound effects with fade in/out.
  95. **Example**:
  96. ```typescript
  97. {
  98. "draft_id": "abc123",
  99. "audio_url": "https://example.com/music.mp3",
  100. "start": 0,
  101. "end": 30,
  102. "volume": 0.5,
  103. "fade_in": 2,
  104. "fade_out": 2
  105. }
  106. ```
  107. ### 4. `capcut_add_text`
  108. Add styled text overlays with animations, shadows, and backgrounds.
  109. **Example**:
  110. ```typescript
  111. {
  112. "draft_id": "abc123",
  113. "text": "Welcome!",
  114. "start": 0,
  115. "end": 3,
  116. "font_size": 72,
  117. "font_color": "#FFFFFF",
  118. "background_color": "#000000",
  119. "shadow_enabled": true,
  120. "animation": "fade_in"
  121. }
  122. ```
  123. ### 5. `capcut_add_image`
  124. Add image overlays with positioning, scaling, and rotation.
  125. **Example**:
  126. ```typescript
  127. {
  128. "draft_id": "abc123",
  129. "image_url": "https://example.com/logo.png",
  130. "start": 0,
  131. "end": 5,
  132. "position_x": 0.9,
  133. "position_y": 0.1,
  134. "scale": 0.3
  135. }
  136. ```
  137. ### 6. `capcut_add_subtitle`
  138. Import subtitles from SRT format with custom styling.
  139. **Example**:
  140. ```typescript
  141. {
  142. "draft_id": "abc123",
  143. "srt_content": "1\n00:00:01,000 --> 00:00:03,000\nWelcome to my video",
  144. "font_size": 36,
  145. "font_color": "#FFFFFF",
  146. "background_enabled": true
  147. }
  148. ```
  149. ### 7. `capcut_add_keyframe`
  150. Create smooth animations using keyframe interpolation.
  151. **Example**:
  152. ```typescript
  153. {
  154. "draft_id": "abc123",
  155. "track_name": "main",
  156. "property_types": ["scale_x", "scale_y"],
  157. "times": [0, 2, 4],
  158. "values": ["1.0", "1.5", "1.0"]
  159. }
  160. ```
  161. ### 8. `capcut_add_effect`
  162. Apply visual effects like blur, brightness, saturation, etc.
  163. **Example**:
  164. ```typescript
  165. {
  166. "draft_id": "abc123",
  167. "effect_name": "blur",
  168. "start": 0,
  169. "end": 2,
  170. "intensity": 0.7
  171. }
  172. ```
  173. ### 9. `capcut_add_sticker`
  174. Add decorative stickers or emojis.
  175. **Example**:
  176. ```typescript
  177. {
  178. "draft_id": "abc123",
  179. "sticker_url": "https://example.com/emoji.png",
  180. "start": 1,
  181. "end": 5,
  182. "position_x": 0.9,
  183. "position_y": 0.1,
  184. "scale": 0.2
  185. }
  186. ```
  187. ### 10. `capcut_save_draft`
  188. Save the draft to import into CapCut application.
  189. **Example**:
  190. ```typescript
  191. {
  192. "draft_id": "abc123"
  193. }
  194. ```
  195. ### 11. `capcut_get_duration`
  196. Get duration and metadata of media files.
  197. **Example**:
  198. ```typescript
  199. {
  200. "url": "https://example.com/video.mp4"
  201. }
  202. ```
  203. ## 📖 Usage Examples
  204. ### Complete Video Creation Workflow
  205. ```typescript
  206. // 1. Create a new draft
  207. const draft = await capcut_create_draft({
  208. width: 1920,
  209. height: 1080,
  210. fps: 30
  211. });
  212. // 2. Add background video
  213. await capcut_add_video({
  214. draft_id: draft.draft_id,
  215. video_url: "https://example.com/background.mp4",
  216. start: 0,
  217. end: 10,
  218. volume: 0.6
  219. });
  220. // 3. Add title text
  221. await capcut_add_text({
  222. draft_id: draft.draft_id,
  223. text: "Amazing Video",
  224. start: 1,
  225. end: 4,
  226. font_size: 72,
  227. animation: "fade_in"
  228. });
  229. // 4. Add background music
  230. await capcut_add_audio({
  231. draft_id: draft.draft_id,
  232. audio_url: "https://example.com/music.mp3",
  233. start: 0,
  234. end: 10,
  235. volume: 0.5
  236. });
  237. // 5. Add zoom animation
  238. await capcut_add_keyframe({
  239. draft_id: draft.draft_id,
  240. track_name: "main",
  241. property_types: ["scale_x", "scale_y"],
  242. times: [0, 5, 10],
  243. values: ["1.0", "1.2", "1.0"]
  244. });
  245. // 6. Save the draft
  246. const result = await capcut_save_draft({
  247. draft_id: draft.draft_id
  248. });
  249. console.log(`Draft saved to: ${result.draft_url}`);
  250. ```
  251. ## 🎯 Use Cases
  252. - **AI-Powered Video Generation**: Let AI assistants create complete video projects
  253. - **Batch Video Production**: Automate creation of multiple videos from templates
  254. - **Social Media Content**: Generate TikTok, Reels, and YouTube Shorts automatically
  255. - **Educational Content**: Create tutorial videos with synchronized text and audio
  256. - **Marketing Automation**: Generate promotional videos at scale
  257. ## 🔍 Troubleshooting
  258. ### Server Not Responding
  259. - Ensure VectCutAPI server is running on port 9001
  260. - Check `CAPCUT_API_URL` environment variable is correct
  261. - Verify network connectivity to the API server
  262. ### Build Errors
  263. ```bash
  264. # Clean and rebuild
  265. rm -rf dist node_modules package-lock.json
  266. npm install
  267. npm run build
  268. ```
  269. ### Media Files Not Found
  270. - Ensure all media URLs are accessible
  271. - Use direct links to files (avoid redirects)
  272. - Check file format is supported
  273. ## 🤝 Contributing
  274. Contributions are welcome! Please feel free to submit a Pull Request.
  275. ## 📄 License
  276. MIT License - feel free to use this in your projects!
  277. ## 🙏 Acknowledgments
  278. - Built on top of [VectCutAPI](https://github.com/sun-guannan/VectCutAPI) by sun-guannan
  279. - Uses the [Model Context Protocol](https://modelcontextprotocol.io/) specification
  280. - Powered by [Anthropic's MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk)
  281. ## 📞 Support
  282. For issues related to:
  283. - **This MCP Server**: Open an issue in this repository
  284. - **VectCutAPI**: Visit https://github.com/sun-guannan/VectCutAPI
  285. - **CapCut Application**: Contact CapCut support
  286. ---
  287. **Note**: This is an unofficial MCP server for CapCut Pro. It requires the VectCutAPI backend to function. CapCut is a trademark of Bytedance Ltd.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.