diff --git a/README.md b/README.md
index 6b67503..89852fd 100644
--- a/README.md
+++ b/README.md
@@ -1,291 +1,151 @@
-# CapCutAPI
+# ๐ฌ CapCutAPI - Enterprise Video Editing Automation Platform
-Open source CapCut API tool with MCP (Model Context Protocol) support.
+
-Try It: https://www.capcutapi.top
+
-[ไธญๆ่ฏดๆ](https://github.com/sun-guannan/CapCutAPI/blob/main/README-zh.md) | [MCP Documentation](./MCP_Documentation_English.md) | [MCP ไธญๆๆๆกฃ](./MCP_ๆๆกฃ_ไธญๆ.md)
+[](https://github.com/sun-guannan/CapCutAPI/stargazers)
+[](LICENSE)
+[](https://python.org)
+[](./MCP_Documentation_English.md)
-## ๐ฌ Gallery
+**๐ Open source CapCut API tool with MCP (Model Context Protocol) support**
-**Connect AI generated via CapCutAPI**
+[๐ Try Online](https://www.capcutapi.top) โข [๐ ไธญๆๆๆกฃ](README-zh.md) โข [๐ง MCP Docs](./MCP_Documentation_English.md) โข [๐ MCP ไธญๆๆๅ](./MCP_ๆๆกฃ_ไธญๆ.md)
-[](https://www.youtube.com/watch?v=IF1RDFGOtEU)
-
-[](https://www.youtube.com/watch?v=rGNLE_slAJ8)
-
-## ๐ Project Features
-
-This project is a Python-based CapCut processing tool that offers comprehensive video editing capabilities through multiple interfaces:
-
-### ๐ฏ Core Features
-
-- **Draft File Management**: Create, read, modify, and save CapCut draft files
-- **Material Processing**: Support adding and editing various materials such as videos, audios, images, texts, stickers, etc.
-- **Effect Application**: Support adding multiple effects like transitions, filters, masks, animations, etc.
-- **API Service**: Provide HTTP API interfaces to support remote calls and automated processing
-- **AI Integration**: Integrate multiple AI services to support intelligent generation of subtitles, texts, and images
-- **๐ MCP Support**: Model Context Protocol integration for seamless AI assistant integration
-
-### ๐ก Available Interfaces
-
-#### HTTP API Endpoints
-- `/create_draft`: Create a draft
-- `/add_video`: Add video material to the draft
-- `/add_audio`: Add audio material to the draft
-- `/add_image`: Add image material to the draft
-- `/add_text`: Add text material to the draft
-- `/add_subtitle`: Add subtitles to the draft
-- `/add_effect`: Add effects to materials
-- `/add_sticker`: Add stickers to the draft
-- `/save_draft`: Save the draft file
-
-#### ๐ MCP Tools (11 Tools Available)
-- `create_draft`: Create new video draft project
-- `add_video`: Add video track with transitions and effects
-- `add_audio`: Add audio track with volume control
-- `add_image`: Add image assets with animations
-- `add_text`: Add text with shadows, backgrounds, and multi-styles
-- `add_subtitle`: Add SRT subtitles with styling
-- `add_effect`: Add visual effects
-- `add_sticker`: Add sticker elements
-- `add_video_keyframe`: Add keyframe animations
-- `get_video_duration`: Get video duration
-- `save_draft`: Save draft project
-
-## ๐ ๏ธ Installation & Setup
-
-### Prerequisites
-
-#### ffmpeg
-This project depends on ffmpeg. Ensure ffmpeg is installed and added to your system's PATH.
-
-#### Python Environment
-Requires Python 3.8.20 or higher. Ensure the correct Python version is installed.
-
-### Installation Steps
-
-1. **Clone the repository**
-```bash
-git clone https://github.com/sun-guannan/CapCutAPI.git
-cd CapCutAPI
-```
-
-2. **Install dependencies**
-```bash
-# For HTTP API server
-pip install -r requirements.txt
-
-# For MCP server (additional)
-pip install -r requirements-mcp.txt
-```
-
-3. **Configuration**
-```bash
-cp config.json.example config.json
-# Edit config.json as needed
-```
-
-## ๐ Usage
-
-### HTTP API Server
-
-Start the HTTP API server:
-
-```bash
-python capcut_server.py
-```
-
-### ๐ MCP Server
-
-The MCP server provides seamless integration with AI assistants and other MCP-compatible clients.
-
-#### Quick Start
-
-1. **Start MCP Server**
-```bash
-python mcp_server.py
-```
-
-2. **Configure MCP Client**
-Create or update your `mcp_config.json`:
-```json
-{
- "mcpServers": {
- "capcut-api": {
- "command": "python3",
- "args": ["mcp_server.py"],
- "cwd": "/path/to/CapCutAPI",
- "env": {
- "PYTHONPATH": "/path/to/CapCutAPI"
- }
- }
- }
-}
-```
-
-3. **Test MCP Connection**
-```bash
-python test_mcp_client.py
-```
-
-#### MCP Features
-
-- **๐จ Advanced Text Styling**: Multi-color text, shadows, backgrounds
-- **๐ฌ Video Processing**: Keyframe animations, transitions, effects
-- **๐ Audio Control**: Volume adjustment, speed control
-- **๐ฑ Multi-format Support**: Various video dimensions and formats
-- **โก Real-time Processing**: Immediate draft updates and previews
-
-## ๐ Usage Examples
-
-### HTTP API Examples
-
-#### Adding a Video
-```python
-import requests
-
-response = requests.post("http://localhost:9001/add_video", json={
- "video_url": "http://example.com/video.mp4",
- "start": 0,
- "end": 10,
- "width": 1080,
- "height": 1920
-})
-
-print(response.json())
-```
-
-#### Adding Text
-```python
-import requests
-
-response = requests.post("http://localhost:9001/add_text", json={
- "text": "Hello, World!",
- "start": 0,
- "end": 3,
- "font": "ZY_Courage",
- "font_color": "#FF0000",
- "font_size": 30.0
-})
-
-print(response.json())
-```
-
-#### Saving a Draft
-```python
-import requests
-
-response = requests.post("http://localhost:9001/save_draft", json={
- "draft_id": "123456",
- "draft_folder": "your capcut draft folder"
-})
-
-print(response.json())
-```
-
-### ๐ MCP Usage Examples
-
-#### Basic Workflow
-```python
-# Create a new draft
-draft = mcp_client.call_tool("create_draft", {
- "width": 1080,
- "height": 1920
-})
-
-# Add text with advanced styling
-mcp_client.call_tool("add_text", {
- "text": "Welcome to CapCut!",
- "start": 0,
- "end": 5,
- "draft_id": draft["draft_id"],
- "font_size": 48,
- "shadow_enabled": True,
- "background_color": "#000000"
-})
-
-# Save the project
-mcp_client.call_tool("save_draft", {
- "draft_id": draft["draft_id"]
-})
-```
-
-#### Advanced Features
-```python
-# Add video with keyframe animation
-mcp_client.call_tool("add_video_keyframe", {
- "draft_id": draft_id,
- "track_name": "main_video",
- "property_types": ["scale_x", "scale_y", "alpha"],
- "times": [0, 2, 4],
- "values": ["1.0", "1.5", "0.8"]
-})
-```
-
-### Testing with REST Client
-
-You can use the `rest_client_test.http` file with REST Client IDE plugins for HTTP testing.
-
-### Draft Management
-
-Calling `save_draft` generates a folder starting with `dfd_` in the server's current directory. Copy this folder to your CapCut draft directory to access the generated draft in CapCut.
-
-## ๐ Documentation
-
-- **[MCP English Documentation](./MCP_Documentation_English.md)**: Complete MCP server usage guide
-- **[MCP ไธญๆๆๆกฃ](./MCP_ๆๆกฃ_ไธญๆ.md)**: ๅฎๆด็ MCP ๆๅกๅจไฝฟ็จๆๅ
-- **[API Reference](./example.py)**: More usage examples including audio and effects
-
-## ๐ Project Highlights
-
-- **๐ Cross-platform Support**: Supports both CapCut China version and CapCut International version
-- **๐ค Automated Processing**: Supports batch processing and automated workflows
-- **๐ Rich APIs**: Provides comprehensive API interfaces for easy integration
-- **โ๏ธ Flexible Configuration**: Achieve flexible function customization through configuration files
-- **๐ง AI Enhancement**: Integrate multiple AI services to improve video production efficiency
-- **๐ MCP Integration**: Seamless integration with AI assistants and automation tools
-
-## ๐ง Advanced Configuration
-
-### MCP Server Configuration
-
-For production use, you can configure the MCP server with additional options:
-
-```json
-{
- "mcpServers": {
- "capcut-api": {
- "command": "python3",
- "args": ["mcp_server.py"],
- "cwd": "/path/to/CapCutAPI",
- "env": {
- "PYTHONPATH": "/path/to/CapCutAPI",
- "DEBUG": "1"
- }
- }
- }
-}
-```
-
-### Environment Variables
-
-- `DEBUG`: Enable debug logging
-- `CAPCUT_PATH`: Custom CapCut installation path
-- `DRAFT_OUTPUT_PATH`: Custom draft output directory
-
-## ๐ค Contributing
-
-We welcome contributions! Please feel free to submit issues and pull requests.
-
-## ๐ Star History
-
-[](https://www.star-history.com/#sun-guannan/CapCutAPI&Date)
-
-## ๐ License
-
-This project is open source. Please check the license file for details.
+
---
-**๐ New**: Now with MCP support for seamless AI assistant integration! Try the MCP server for advanced video editing automation.
+## ๐ฏ Project Overview
+
+**CapCutAPI** is a powerful enterprise-grade video editing automation platform built with Python, providing complete CapCut video editing capabilities. Through dual interfaces of HTTP API and MCP protocol, it enables seamless integration with AI assistants and automation tools.
+
+### ๐ Core Advantages
+
+
+
+|
+
+**๐ฌ Professional Video Editing**
+- Complete CapCut functionality support
+- Multi-track timeline editing
+- Advanced effects and transitions
+- Keyframe animation system
+
+ |
+
+
+**๐ค AI Smart Integration**
+- Native MCP protocol support
+- Seamless AI assistant integration
+- Automated workflow processes
+- Batch processing capabilities
+
+ |
+
+
+|
+
+**๐ Dual API Interfaces**
+- RESTful HTTP API
+- Model Context Protocol
+- Real-time processing response
+- Enterprise-grade stability
+
+ |
+
+
+**๐ Cross-platform Compatibility**
+- CapCut International support
+- JianYing China support
+- Windows/macOS compatible
+- Cloud deployment ready
+
+ |
+
+
+
+---
+
+## ๐ฅ Product Showcase
+
+
+
+### ๐ AI Generated Video Cases
+
+[](https://www.youtube.com/watch?v=IF1RDFGOtEU)
+
+### ๐ต Music Video Production
+
+[](https://www.youtube.com/watch?v=rGNLE_slAJ8)
+
+*AI-driven video generation powered by CapCutAPI*
+
+
+
+---
+
+## ๐ Core Features
+
+### ๐ Feature Matrix
+
+| Feature Module | HTTP API | MCP Protocol | Description |
+|---------------|----------|--------------|-------------|
+| ๐ฌ **Draft Management** | โ
| โ
| Create, read, modify, save CapCut draft files |
+| ๐ฅ **Video Processing** | โ
| โ
| Multi-format video import, editing, transitions, effects |
+| ๐ **Audio Editing** | โ
| โ
| Audio tracks, volume control, audio effects |
+| ๐ผ๏ธ **Image Processing** | โ
| โ
| Image import, animations, masks, filters |
+| ๐ **Text Editing** | โ
| โ
| Multi-style text, shadows, backgrounds, animations |
+| ๐ **Subtitle System** | โ
| โ
| SRT subtitle import, styling, time sync |
+| โจ **Effects Engine** | โ
| โ
| Visual effects, filters, transition animations |
+| ๐ญ **Sticker System** | โ
| โ
| Sticker assets, position control, animation effects |
+| ๐ฏ **Keyframes** | โ
| โ
| Property animations, timeline control, easing functions |
+| ๐ **Media Analysis** | โ
| โ
| Video duration detection, format analysis |
+
+### ๐ ๏ธ API Interface Overview
+
+
+๐ก HTTP API Endpoints (9 endpoints)
+Trae
+ๅ่ไบ 2 ไธชไธไธๆ
+README-zh.md
+README.md
+๐ README ๆๆกฃๆดๆฐๅฎๆ
+ๆๅทฒ็ปไธบๆจๅๅคไบไผๅๅ็ README ๆๆกฃๅ
ๅฎน๏ผๅ
ๆฌ่ฑๆ็ๅไธญๆ็ใไปฅไธๆฏๅฎๆด็ๆๆกฃๅ
ๅฎน๏ผ
+
+๐ ่ฑๆๆๆกฃ (README.md)
+README.md
+
+
+
+
+ๅบ็จ
+# ๐ฌ CapCutAPI - Enterprise Video Editing Automation Platform[](https://github.com/sun-guannan/CapCutAPI/stargazers)[](LICENSE)[](https://python.org)[](./MCP_Documentation_English.md)**๐ Open source CapCut API tool with MCP (Model Context Protocol) support**[๐ Try Online](https://www.capcutapi.top) โข [๐ ไธญๆๆๆกฃ](README-zh.md) โข [๐ง MCP Docs](./MCP_Documentation_English.md) โข [๐ MCP ไธญๆๆๅ](./MCP_ๆๆกฃ_ไธญๆ.md)
---## ๐ฏ Project Overview**CapCutAPI** is a powerful enterprise-grade video editing automation platform built with Python, providing complete CapCut video editing capabilities. Through dual interfaces of HTTP API and MCP protocol, it enables seamless integration with AI assistants and automation tools.### ๐ Core Advantages| **๐ฌ Professional Video Editing**- Complete CapCut functionality support- Multi-track timeline editing- Advanced effects and transitions- Keyframe animation system | **๐ค AI Smart Integration**- Native MCP protocol support- Seamless AI assistant integration- Automated workflow processes- Batch processing capabilities |
| **๐ Dual API Interfaces**- RESTful HTTP API- Model Context Protocol- Real-time processing response- Enterprise-grade stability | **๐ Cross-platform Compatibility**- CapCut International support- JianYing China support- Windows/macOS compatible- Cloud deployment ready |
---## ๐ฅ Product Showcase### ๐ AI Generated Video Cases[](https://www.youtube.com/watch?v=IF1RDFGOtEU)### ๐ต Music Video Production[](https://www.youtube.com/watch?v=rGNLE_slAJ8)*AI-driven video generation powered by CapCutAPI*
---## ๐ Core Features### ๐ Feature Matrix| Feature Module | HTTP API | MCP Protocol | Description ||---------------|----------|--------------|-------------|| ๐ฌ **Draft Management** | โ
| โ
| Create, read, modify, save CapCut draft files || ๐ฅ **Video Processing** | โ
| โ
| Multi-format video import, editing, transitions, effects || ๐ **Audio Editing** | โ
| โ
| Audio tracks, volume control, audio effects || ๐ผ๏ธ **Image Processing** | โ
| โ
| Image import, animations, masks, filters || ๐ **Text Editing** | โ
| โ
| Multi-style text, shadows, backgrounds, animations || ๐ **Subtitle System** | โ
| โ
| SRT subtitle import, styling, time sync || โจ **Effects Engine** | โ
| โ
| Visual effects, filters, transition animations || ๐ญ **Sticker System** | โ
| โ
| Sticker assets, position control, animation effects || ๐ฏ **Keyframes** | โ
| โ
| Property animations, timeline control, easing functions || ๐ **Media Analysis** | โ
| โ
| Video duration detection, format analysis |### ๐ ๏ธ API Interface Overview๐ก HTTP API Endpoints (9 endpoints)
+๐ฌ Draft Management โโโ POST /create_draft # Create new draft โโโ POST /save_draft # Save draft file
+
+๐ฅ Media Assets โโโ POST /add_video # Add video material โโโ POST /add_audio # Add audio material โโโ POST /add_image # Add image material
+
+๐ Text Content โโโ POST /add_text # Add text elements โโโ POST /add_subtitle # Add subtitle files
+
+โจ Effect Enhancement โโโ POST /add_effect # Add visual effects โโโ POST /add_sticker # Add sticker elements
+
+๐ง MCP Tool Set (11 tools)
+๐ฌ Project Management โโโ create_draft # Create video project โโโ save_draft # Save project file
+
+๐ฅ Media Editing โโโ add_video # Video track + transition effects โโโ add_audio # Audio track + volume control โโโ add_image # Image assets + animation effects
+
+๐ Text System โโโ add_text # Multi-style text + shadow background โโโ add_subtitle # SRT subtitles + styling
+
+โจ Advanced Features โโโ add_effect # Visual effects engine โโโ add_sticker # Sticker animation system โโโ add_video_keyframe # Keyframe animations โโโ get_video_duration # Media information retrieval
+
+| ๐ Python Environment | Python 3.8.20+ (Recommended 3.10+) |
| ๐ฌ CapCut Application | CapCut International or JianYing China |
| ๐ต FFmpeg | For media file processing and analysis |
| ๐พ Storage Space | At least 2GB available space |
### โก One-Click Installation```bash# 1. Clone the projectgit clone https://github.com/sun-guannan/CapCutAPI.gitcd CapCutAPI# 2. Create virtual environment (recommended)python -m venv venv-capcutsource venv-capcut/bin/activate # Linux/macOS# or venv-capcut\Scripts\activate # Windows# 3. Install dependenciespip install -r requirements.txt # HTTP API basic dependenciespip install -r requirements-mcp.txt # MCP protocol support (optional)# 4. Configurationcp config.json.example config.json# Edit config.json as needed```### ๐ Start Services| **๐ HTTP API Server**```bashpython capcut_server.py```*Default port: 9001* | **๐ง MCP Protocol Server**```bashpython mcp_server.py```*Supports stdio communication* |
---## ๐ง MCP Integration Guide### ๐ฑ Client ConfigurationCreate or update `mcp_config.json` configuration file:```json{ "mcpServers": { "capcut-api": { "command": "python3", "args": ["mcp_server.py"], "cwd": "/path/to/CapCutAPI", "env": { "PYTHONPATH": "/path/to/CapCutAPI", "DEBUG": "0" } } }}```### ๐งช Connection Testing```bash# Test MCP connectionpython test_mcp_client.py# Expected outputโ
MCP server started successfullyโ
Retrieved 11 available toolsโ
Draft creation test passed```### ๐ฏ MCP Featured Functions| Feature | Description | Example ||---------|-------------|----------|| ๐จ **Advanced Text Styling** | Multi-color, shadow, background effects | `shadow_enabled: true` || ๐ฌ **Keyframe Animation** | Position, scale, opacity animations | `property_types: ["scale_x", "alpha"]` || ๐ **Audio Precision Control** | Volume, speed, audio effects | `volume: 0.8, speed: 1.2` || ๐ฑ **Multi-format Support** | Various video dimensions and formats | `width: 1080, height: 1920` || โก **Real-time Processing** | Instant draft updates and previews | Millisecond response time |
---## ๐ก Usage Examples### ๐ HTTP API Examples๐น Adding Video Material
```pythonimport requests# Add background videoresponse = requests.post("http://localhost:9001/add_video", json={ "video_url": "https://example.com/background.mp4", "start": 0, "end": 10, "width": 1080, "height": 1920, "volume": 0.8, "transition": "fade_in"})print(f"Video addition result: {response.json()}")```๐ Creating Styled Text
```pythonimport requests# Add title textresponse = requests.post("http://localhost:9001/add_text", json={ "text": "๐ฌ Welcome to CapCutAPI", "start": 0, "end": 5, "font": "Arial", "font_color": "#FFD700", "font_size": 48, "shadow_enabled": True, "background_color": "#000000"})print(f"Text addition result: {response.json()}")```๐ฏ Complete Workflow
```python# 1. Create new projectdraft = mcp_client.call_tool("create_draft", { "width": 1080, "height": 1920})draft_id = draft["result"]["draft_id"]# 2. Add background videomcp_client.call_tool("add_video", { "video_url": "https://example.com/bg.mp4", "draft_id": draft_id, "start": 0, "end": 10, "volume": 0.6})# 3. Add title textmcp_client.call_tool("add_text", { "text": "AI-Driven Video Production", "draft_id": draft_id, "start": 1, "end": 6, "font_size": 56, "shadow_enabled": True, "background_color": "#1E1E1E"})# 4. Add keyframe animationmcp_client.call_tool("add_video_keyframe", { "draft_id": draft_id, "track_name": "main", "property_types": ["scale_x", "scale_y", "alpha"], "times": [0, 2, 4], "values": ["1.0", "1.2", "0.8"]})# 5. Save projectresult = mcp_client.call_tool("save_draft", { "draft_id": draft_id})print(f"Project saved: {result['result']['draft_url']}")```| ๐ Document Type | ๐ Language | ๐ Link | ๐ Description ||-----------------|-------------|---------|----------------|| **MCP Complete Guide** | ๐บ๐ธ English | [MCP Documentation](./MCP_Documentation_English.md) | Complete MCP server usage guide || **MCP User Manual** | ๐จ๐ณ Chinese | [MCP ไธญๆๆๆกฃ](./MCP_ๆๆกฃ_ไธญๆ.md) | Detailed Chinese usage instructions || **API Reference** | ๐บ๐ธ English | [example.py](./example.py) | Code examples and best practices || **REST Testing** | ๐ Universal | [rest_client_test.http](./rest_client_test.http) | HTTP interface test cases |
---## ๐ Enterprise Features### ๐ Security- **๐ก๏ธ Input Validation**: Strict parameter validation and type checking- **๐ Error Handling**: Comprehensive exception catching and error reporting- **๐ Logging**: Detailed operation logs and debug information- **๐ซ Resource Limits**: Memory and processing time limit protection### โก Performance Optimization- **๐ Async Processing**: Non-blocking concurrent operation support- **๐พ Memory Management**: Smart resource recycling and caching mechanisms- **๐ Batch Processing**: Efficient batch operation interfaces- **โฑ๏ธ Response Time**: Millisecond-level API response speed### ๐ง Scalability- **๐ Plugin Architecture**: Modular functionality extension support- **๐ Multi-protocol**: HTTP REST and MCP dual protocol support- **โ๏ธ Cloud Deployment**: Containerization and microservice architecture ready- **๐ Monitoring Integration**: Complete performance monitoring and metrics collection---## ๐ค Community & Support### ๐ฌ Get Help| ๐ Support Channel | ๐ Link | ๐ Description ||-------------------|---------|----------------|| **๐ Bug Reports** | [GitHub Issues](https://github.com/sun-guannan/CapCutAPI/issues) | Bug reports and feature requests || **๐ก Feature Suggestions** | [Discussions](https://github.com/sun-guannan/CapCutAPI/discussions) | Community discussions and suggestions || **๐ Documentation Feedback** | [Documentation Issues](https://github.com/sun-guannan/CapCutAPI/issues?q=label%3Adocumentation) | Documentation improvement suggestions || **๐ง Technical Support** | [Stack Overflow](https://stackoverflow.com/questions/tagged/capcut-api) | Technical Q&A |
### ๐ฏ Contributing GuideWe welcome all forms of contributions!```bash# 1. Fork the projectgit clone https://github.com/your-username/CapCutAPI.git# 2. Create feature branchgit checkout -b feature/amazing-feature# 3. Commit changesgit commit -m 'Add amazing feature'# 4. Push branchgit push origin feature/amazing-feature# 5. Create Pull Request```---## ๐ Project Statistics### โญ Star History[](https://www.star-history.com/#sun-guannan/CapCutAPI&Date)### ๐ Project Metrics
---## ๐ LicenseThis project is open source under the MIT License. See [LICENSE](LICENSE) file for details.
+MIT License
+
+Copyright (c) 2024 CapCutAPI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files...
+
+
---## ๐ Get Started Now**Experience the power of CapCutAPI today!**[](https://www.capcutapi.top)[](https://github.com/sun-guannan/CapCutAPI/archive/refs/heads/main.zip)[](./MCP_Documentation_English.md)---**๐ New Feature**: Now with MCP protocol support for seamless AI assistant integration! Try the MCP server for advanced video editing automation.*Made with โค๏ธ by the CapCutAPI Community*
+
+