How spectrika/capcut-mcp works
capcut-mcp is an MCP server that lets AI clients create CapCut 9.3 drafts and edit existing projects. The main workflow is client tool calls into the server, followed by draft creation or project loading, timeline operations, and writing project files to CapCut’s projects directory. README documents additional media, text, effects, masks, and project-management tools. entry.py was not sampled, so its internal dispatch structure is represented only at the documented tool level; timeline_edit.py is shown as the editing layer it identifies itself as serving.
Main entry points: entry.py MCP Server · timeline_edit.py Timeline Operations
Components 21
MCP Interface
- MCP Server
entry.py - Health Check
entry.py
Project Workflows
- Draft Creation
entry.py - Media Tools
entry.py - Captions and Text
entry.py - Effects and Stickers
entry.py - Video Keyframes
entry.py - Project Discovery
entry.py - Project Loading
entry.py - Draft Description
entry.py - Draft Saving
entry.py
Timeline Editing
- Range Editing
entry.py - Segment Editing
entry.py - Text Editing
entry.py - Track Settings
entry.py - Blur and Masks
entry.py - Timeline Operations
timeline_edit.py
Project and Media I/O
- CapCut Projects
- Media Files
Other components
- MCP Client
- CapCut Desktop
Connections 23
- MCP Client → MCP Server: calls tools
README.md - MCP Server → Health Check: dispatches
README.md - MCP Server → Draft Creation: dispatches
README.md - MCP Server → Media Tools: dispatches
README.md - MCP Server → Captions and Text: dispatches
README.md - MCP Server → Effects and Stickers: dispatches
README.md - MCP Server → Video Keyframes: dispatches
README.md - MCP Server → Project Discovery: dispatches
README.md - MCP Server → Project Loading: dispatches
README.md - MCP Server → Draft Description: dispatches
README.md - MCP Server → Range Editing: dispatches
README.md - MCP Server → Segment Editing: dispatches
README.md - MCP Server → Text Editing: dispatches
README.md - MCP Server → Track Settings: dispatches
README.md - MCP Server → Blur and Masks: dispatches
README.md - MCP Server → Draft Saving: dispatches
README.md - MCP Server → Timeline Operations: uses
timeline_edit.py - Media Tools → Media Files: reads media
README.md - Captions and Text → Media Files: reads subtitles
README.md - Project Discovery → CapCut Projects: lists projects
README.md - Project Loading → CapCut Projects: opens project
README.md - Draft Saving → CapCut Projects: writes project
README.md - CapCut Desktop → CapCut Projects: opens projects
README.md