davinci-resolve-mcp

🚀 用于集成人工智能助手与DaVinci Resolve的MCP协议实现

本项目是一个基于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/目录中的日志文件以进行故障排除。

通用步骤

1. 启动DaVinci Resolve。
2. 启动MCP服务器：python src/main.py。
3. 在AI助手中配置MCP连接参数。

配置文件示例（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 - 项目变更日志

相关链接

• DaVinci Resolve官方文档
• MCP协议规范

错误排除

• 问题：连接时出现错误。

• 解决：检查防火墙设置，确保端口开放。

• 问题：服务器启动失败。

• 解决：检查Python版本和依赖项是否正确安装。

项目变更日志

v1.0.0（2023年10月）

• 新功能：
  • 初始版本发布。
  • 添加了基本的MCP接口实现。
  • 支持DaVinci Resolve的基本控制命令。
• 改动：
  • 更新了项目结构以支持模块化开发。
  • 增加了详细的日志记录功能。
  • 优化了错误处理机制。

v1.1.0（2023年11月）

• 新功能：
  • 添加了批量处理脚本支持。
  • 支持多平台兼容性改进。
  • 引入了新的配置管理功能。
• 改动：
  • 更新了文档以反映新功能。
  • 修复了一些已知的稳定性问题。
  • 提高了性能和响应速度。

v1.2.0（2024年1月）

• 新功能：
  • 添加了日志记录模块。
  • 支持自定义命令扩展。
  • 引入了新的错误处理机制。

📄 许可证

• 项目采用MIT许可证。
• 欢迎 fork 和提交Pull Request。
• 请在GitHub Issues中报告问题和建议功能。

联系方式

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