项目说明

这个项目是一个用于将人工智能助手与DaVinci Resolve集成的MCP协议实现。它允许AI助手直接控制和自动化DaVinci Resolve的工作流程。

目标

• 实现DaVinci Resolve与AI助手之间的通信
• 提供自动化工具以提高视频编辑效率
• 支持多种操作系统（Windows、macOS、Linux）

特性

• 通过MCP协议实现远程过程调用(RPC)
• 支持批量处理脚本
• 提供详细的日志记录和错误处理
• 完全开源，允许自定义和扩展

快速开始

入门指南

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 项目变更日志文档

安装说明

通过脚本安装

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服务器：python src/main.py
3. 在AI助手中配置MCP连接参数。

配置文件示例（Linux）

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

常见问题

• 问题：连接时出现错误。
• 解决：检查防火墙设置，确保端口开放。

相关链接

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

贡献指南

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

联系方式

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

项目文档

安装指南

系统要求

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

安装步骤

1. 克隆仓库：

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

2. 进入项目目录：

   cd davinci-resolve-mcp
   

3. 安装依赖项：

   pip install -r requirements.txt
   

4. 设置环境变量（Linux/macOS）：

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

5. 启动服务器：

   python src/main.py
   

使用说明

基本用法

1. 启动DaVinci Resolve。
2. 运行MCP服务器脚本start-server.sh。
3. 配置AI助手连接到MCP服务器。

高级功能

• 批处理：使用run-server.sh进行批量任务。
• 自定义：修改配置文件以添加自定义行为。
• 日志：查看logs/目录中的日志文件以进行故障排除。

代码结构

davinci-resolve-mcp/
├── src/
│   ├── main.py - 主要的服务器入口点
│   ├── services/
│   │   └── resolve_service.py - DaVinci Resolve与MCP之间的接口
│   └── utils/
│       └── logger.py - 日志记录工具
├── config/
│   └── mcp_config.json - MCP服务器配置文件
└── docs/
    └── CHANGELOG.md - 项目变更日志

示例

启动MCP服务器

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

调用示例命令

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

错误排除

• 问题：服务器启动失败。
• 解决：检查Python版本和依赖项是否正确安装。

项目变更日志

v1.0.0（2023年10月）

新功能

• 初始版本发布
• 添加了基本的MCP接口实现
• 支持DaVinci Resolve的基本控制命令

改动

• 更新了项目结构以支持模块化开发
• 增加了详细的日志记录功能
• 优化了错误处理机制

v1.1.0（2023年11月）

新功能

• 添加了批量处理脚本支持
• 支持多平台兼容性改进
• 引入了新的配置管理功能

改动

• 更新了文档以反映新功能
• 修复了一些已知的稳定性问题
• 提高了性能和响应速度

v1.2.0（2024年1月）

新功能

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

改动