Davinci Resolve MCP

🚀 人工智能助手與DaVinci Resolve集成項目

本項目是一個基於MCP協議的實現，旨在將人工智能助手與DaVinci Resolve進行集成。通過該項目，AI助手能夠直接控制並自動化DaVinci Resolve的工作流程，顯著提升視頻編輯的效率。

🚀 快速開始

入門指南

1. 安裝依賴：
   • 確保系統已安裝Python 3.8或更高版本。
   • 運行pip install -r requirements.txt安裝所有必要庫。
2. 設置環境變量（僅限Linux/macOS）：

   export PYTHONPATH="${PYTHONPATH}:/path/to/your/project"
   

3. 啟動服務器：
   • 執行命令python src/main.py啟動MCP服務器。

項目結構

davinci-resolve-mcp/
├── resolve_mcp_server.py - 主要的MCP服務器實現
├── run-now.sh - 快速啟動腳本，負責環境設置和啟動服務器
├── setup.sh - 完整安裝腳本
├── check-resolve-ready.sh - 啟動前檢查腳本，驗證DaVinci Resolve是否準備好
├── start-server.sh - 啟動服務器的腳本
├── run-server.sh - 簡化的運行服務器腳本
└── docs/ CHANGELOG.md 項目變更日誌文檔

✨ 主要特性

• 通過MCP協議實現遠程過程調用(RPC)。
• 支持批量處理腳本，提高處理效率。
• 提供詳細的日誌記錄和錯誤處理，便於問題排查。
• 完全開源，允許用戶根據需求進行自定義和擴展。

📦 安裝指南

系統要求

• 操作系統：Windows、macOS、Linux。
• Python版本：3.8+。

通過腳本安裝

1. 克隆倉庫：

   git clone https://github.com/samuelgursky/davinci-resolve-mcp.git
   cd davinci-resolve-mcp
   

2. 運行設置腳本：

   ./setup.sh
   

3. 安裝完成後，運行：

   ./run-now.sh
   

手動安裝

1. 下載源代碼並解壓。
2. 將項目添加到Python路徑中。
3. 運行pip install -r requirements.txt安裝依賴項。

💻 使用示例

基礎用法

1. 啟動DaVinci Resolve。
2. 運行MCP服務器腳本start-server.sh。
3. 配置AI助手連接到MCP服務器。

高級用法

• 批處理：使用run-server.sh進行批量任務。
• 自定義：修改配置文件以添加自定義行為。
• 日誌：查看logs/目錄中的日誌文件以進行故障排除。

配置文件示例（Linux）

{
    "mcpServers": {
        "davinci-resolve": {
            "name": "DaVinci Resolve MCP",
            "host": "localhost",
            "port": 5000
        }
    }
}

常見問題

• 問題：連接時出現錯誤。
• 解決：檢查防火牆設置，確保端口開放。

示例命令

啟動MCP服務器

python src/main.py --host localhost --port 5000

調用示例命令

curl -X POST http://localhost:5000/api/resolve/process_clip

📚 詳細文檔

代碼結構

davinci-resolve-mcp/
├── src/
│   ├── main.py - 主要的服務器入口點
│   ├── services/
│   │   └── resolve_service.py - DaVinci Resolve與MCP之間的接口
│   └── utils/
│       └── logger.py - 日誌記錄工具
├── config/
│   └── mcp_config.json - MCP服務器配置文件
└── docs/
    └── CHANGELOG.md - 項目變更日誌

錯誤排除

• 問題：服務器啟動失敗。
• 解決：檢查Python版本和依賴項是否正確安裝。

🔧 技術細節

本項目通過MCP協議實現了DaVinci Resolve與AI助手之間的通信。在項目開發過程中，採用了模塊化的設計思想，將不同的功能模塊進行分離，提高了代碼的可維護性和可擴展性。同時，為了方便用戶使用和問題排查，項目提供了詳細的日誌記錄和錯誤處理機制。

📄 許可證

本項目採用MIT許可證。

相關鏈接

• DaVinci Resolve官方文檔
• MCP協議規範

貢獻指南

歡迎 fork 本項目並提交Pull Request。請在GitHub Issues中報告問題和建議功能。

聯繫方式

作者：Samuel Gursky
郵箱：samgursky@gmail.com
GitHub：github.com/samuelgursky

項目變更日誌

v1.0.0（2023年10月）

新功能

• 初始版本發佈。
• 添加了基本的MCP接口實現。
• 支持DaVinci Resolve的基本控制命令。

改動

• 更新了項目結構以支持模塊化開發。
• 增加了詳細的日誌記錄功能。
• 優化了錯誤處理機制。

v1.1.0（2023年11月）

新功能

• 添加了批量處理腳本支持。
• 支持多平臺兼容性改進。
• 引入了新的配置管理功能。

改動

• 更新了文檔以反映新功能。
• 修復了一些已知的穩定性問題。
• 提高了性能和響應速度。

v1.2.0（2024年1月）

新功能

• 添加了日誌記錄模塊。
• 支持自定義命令擴展。
• 引入了新的錯誤處理機制。

改動

（原文檔此處未詳細說明，可根據實際情況補充）