Video Editing MCP

🚀 Video Editor MCP Server

This is an MCP (Model Context Protocol) server for video editing. It comes with a screenshot link [Insert screenshot link here] and a YouTube demonstration link [Insert YouTube link here].

🚀 Quick Start

📦 Installation

Follow these steps to quickly install and run the Video Editor MCP Server:

1. Clone the repository:

   git clone git@github.com:yourusername/video-editor-mcp.git
   cd video-editor-mcp
   

2. Synchronize dependencies and generate a lock file:

   uv sync
   

3. Build the distribution package:

   uv build
   

4. Install to PyPI:

   uv publish
   

⚙️ Configuration

Create a configuration file in the video-editor-mcp directory with the following content:

{
  "development": {
    "api_key": "your_api_key_here"
  }
}

✨ Features

• Video Editor MCP Server: A video editing tool based on the Model Context Protocol.
• API Key: A valid API key is required to access the service, which can be obtained on the settings page.

📦 Resources

Video Editor MCP Server

• Overview: Provides a video editing solution based on the Model Context Protocol.
• Screenshot Link: [Insert screenshot link here]
• Demo Link: [Insert YouTube demonstration link here]

💻 Usage Examples

🔨 Basic Usage

1. Clone the repository and install dependencies.
2. Set the environment variable:

   export API_KEY=your_api_key_here
   

3. Start the server:

   uv run video-editor-mcp your_api_key_here
   

⚙️ Advanced Usage

• Start in .photos mode:

  uv run --mode .photos video-editor-mcp your_api_key_here
  

• Start with a specified directory:

  uv run --directory /path/to/video-editor-mcp video-editor-mcp your_api_key_here
  

🛠️ Development

🏗️ Build and Publish

1. Synchronize dependencies and generate a lock file:

   uv sync
   

2. Build the distribution package:

   uv build
   

3. Publish to PyPI:

   uv publish
   

🐞 Debugging

Since the MCP server runs through standard input and output, debugging can be challenging. It is recommended to use MCP Inspector for debugging.

Start the Inspector:

npx @modelcontextprotocol/inspector uv run --directory /Users/YOURDIRECTORY/video-editor-mcp video-editor-mcp YOURAPIKEY

📝 Monitoring Logs

Create an app.log file in the project directory to record runtime information. You can view the logs in real-time using the following command:

tail -n 90 -f app.log

💻 Complete Code Examples

📋 Simple Example

from video_editor_mcp import VideoEditor

editor = VideoEditor(api_key="your_api_key_here")
editor.edit_video("input.mp4", "output.mp4")

📈 Advanced Example

import logging
from video_editor_mcp import VideoEditor

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

def on_progress(percent):
    logger.info(f"Video editing progress: {percent}%")

editor = VideoEditor(
    api_key="your_api_key_here",
    on_progress=on_progress
)

editor.edit_video("input.mp4", "output.mp4", {
    "quality": "high",
    "resolution": "1080p"
})

📚 Appendix

❌ Error Handling

try:
    editor.edit_video("invalid_file.mp4", "result.mp4")
except Exception as e:
    logger.error(f"Video editing failed: {str(e)}")

⚙️ Configuration Options

{
  "api_key": "your_api_key_here",
  "preferences": {
    "cache_location": "/path/to/cache",
    "log_level": "info"
  }
}

🌐 Environment Variable Configuration

Set the following environment variables to configure the server:

• VIDEO_EDITOR_API_KEY: API key
• VIDEO_EDITOR_CACHE: Cache directory path

👥 Contributors

[List project contributors here]

📄 License

[Insert license information here]