# MCP Server Bailian Video Synthesis
阿里云百炼-通义万相视频编辑统一模型MCP服务器
## 功能特性
- **多图参考视频生成**: 基于多张参考图片生成视频
- **视频重绘**: 对现有视频进行重新绘制
- **局部编辑**: 对视频的特定区域进行编辑
- **视频延展**: 延长视频时长
- **视频画面扩展**: 扩展视频画面范围
- **异步任务处理**: 支持创建任务和查询结果的异步操作
- **易于集成**: 标准MCP协议，可与Claude Desktop等工具无缝集成
## 安装
### 从PyPI安装
```bash
pip install mcp-server-bailian-video-synthesis
```
### 从源码安装
```bash
git clone <repository-url>
cd mcp_server_bailian_video_synthesis
pip install -e .
```
## 配置
### 获取API密钥
1. 访问[阿里云百炼控制台](https://bailian.console.aliyun.com/)
2. 创建应用并获取API Key
3. 设置环境变量或在启动时传入API Key
### 环境变量设置
```bash
export DASHSCOPE_API_KEY="your-api-key-here"
```
## 使用方法
### 启动MCP服务器
```bash
# 使用uvx启动（推荐）
uvx mcp-server-bailian-video-synthesis
# 或者直接传入API Key
uvx mcp-server-bailian-video-synthesis --api-key your-api-key-here
```
### Claude Desktop配置
在Claude Desktop的配置文件中添加：
```json
{
"mcpServers": {
"bailian-video-synthesis": {
"command": "uvx",
"args": ["mcp-server-bailian-video-synthesis"],
"env": {
"DASHSCOPE_API_KEY": "your-api-key-here"
}
}
}
}
```
## 支持的工具
### 创建任务工具
- `create_task_image_reference`: 多图参考视频生成
- `create_task_video_repainting`: 视频重绘
- `create_task_video_edit`: 局部编辑
- `create_task_video_extension`: 视频延展
- `create_task_video_expansion`: 视频画面扩展
### 查询结果工具
- `get_task_result`: 根据任务ID查询处理结果
## 错误处理
服务器会自动处理以下错误情况：
- API密钥无效或缺失
- 网络连接问题
- 参数验证错误
- 任务处理失败
## 开发
### 安装开发依赖
```bash
pip install -e ".[dev]"
```
### 运行测试
```bash
pytest
```
### 代码格式化
```bash
black .
isort .
```
## 许可证
MIT License
## 相关链接
- [阿里云百炼官方文档](https://help.aliyun.com/zh/model-studio/)
- [视频生成API文档](https://help.aliyun.com/zh/model-studio/video-generation-api/)
- [MCP协议规范](https://github.com/modelcontextprotocol/specification)
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-server-bailian-video-synthesis",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mcp, model-context-protocol, aliyun, bailian, video, ai",
"author": null,
"author_email": "John Chen <john.chen@example.com>",
"download_url": "https://files.pythonhosted.org/packages/2a/b7/d189aa6d4f34dafb5e15ab4017c6f637640ac50051135c82a5d62f202ff3/mcp_server_bailian_video_synthesis-1.0.4.tar.gz",
"platform": null,
"description": "# MCP Server Bailian Video Synthesis\n\n\u963f\u91cc\u4e91\u767e\u70bc-\u901a\u4e49\u4e07\u76f8\u89c6\u9891\u7f16\u8f91\u7edf\u4e00\u6a21\u578bMCP\u670d\u52a1\u5668\n\n## \u529f\u80fd\u7279\u6027\n\n- **\u591a\u56fe\u53c2\u8003\u89c6\u9891\u751f\u6210**: \u57fa\u4e8e\u591a\u5f20\u53c2\u8003\u56fe\u7247\u751f\u6210\u89c6\u9891\n- **\u89c6\u9891\u91cd\u7ed8**: \u5bf9\u73b0\u6709\u89c6\u9891\u8fdb\u884c\u91cd\u65b0\u7ed8\u5236\n- **\u5c40\u90e8\u7f16\u8f91**: \u5bf9\u89c6\u9891\u7684\u7279\u5b9a\u533a\u57df\u8fdb\u884c\u7f16\u8f91\n- **\u89c6\u9891\u5ef6\u5c55**: \u5ef6\u957f\u89c6\u9891\u65f6\u957f\n- **\u89c6\u9891\u753b\u9762\u6269\u5c55**: \u6269\u5c55\u89c6\u9891\u753b\u9762\u8303\u56f4\n- **\u5f02\u6b65\u4efb\u52a1\u5904\u7406**: \u652f\u6301\u521b\u5efa\u4efb\u52a1\u548c\u67e5\u8be2\u7ed3\u679c\u7684\u5f02\u6b65\u64cd\u4f5c\n- **\u6613\u4e8e\u96c6\u6210**: \u6807\u51c6MCP\u534f\u8bae\uff0c\u53ef\u4e0eClaude Desktop\u7b49\u5de5\u5177\u65e0\u7f1d\u96c6\u6210\n\n## \u5b89\u88c5\n\n### \u4ecePyPI\u5b89\u88c5\n\n```bash\npip install mcp-server-bailian-video-synthesis\n```\n\n### \u4ece\u6e90\u7801\u5b89\u88c5\n\n```bash\ngit clone <repository-url>\ncd mcp_server_bailian_video_synthesis\npip install -e .\n```\n\n## \u914d\u7f6e\n\n### \u83b7\u53d6API\u5bc6\u94a5\n\n1. \u8bbf\u95ee[\u963f\u91cc\u4e91\u767e\u70bc\u63a7\u5236\u53f0](https://bailian.console.aliyun.com/)\n2. \u521b\u5efa\u5e94\u7528\u5e76\u83b7\u53d6API Key\n3. \u8bbe\u7f6e\u73af\u5883\u53d8\u91cf\u6216\u5728\u542f\u52a8\u65f6\u4f20\u5165API Key\n\n### \u73af\u5883\u53d8\u91cf\u8bbe\u7f6e\n\n```bash\nexport DASHSCOPE_API_KEY=\"your-api-key-here\"\n```\n\n## \u4f7f\u7528\u65b9\u6cd5\n\n### \u542f\u52a8MCP\u670d\u52a1\u5668\n\n```bash\n# \u4f7f\u7528uvx\u542f\u52a8\uff08\u63a8\u8350\uff09\nuvx mcp-server-bailian-video-synthesis\n\n# \u6216\u8005\u76f4\u63a5\u4f20\u5165API Key\nuvx mcp-server-bailian-video-synthesis --api-key your-api-key-here\n```\n\n### Claude Desktop\u914d\u7f6e\n\n\u5728Claude Desktop\u7684\u914d\u7f6e\u6587\u4ef6\u4e2d\u6dfb\u52a0\uff1a\n\n```json\n{\n \"mcpServers\": {\n \"bailian-video-synthesis\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-bailian-video-synthesis\"],\n \"env\": {\n \"DASHSCOPE_API_KEY\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n## \u652f\u6301\u7684\u5de5\u5177\n\n### \u521b\u5efa\u4efb\u52a1\u5de5\u5177\n\n- `create_task_image_reference`: \u591a\u56fe\u53c2\u8003\u89c6\u9891\u751f\u6210\n- `create_task_video_repainting`: \u89c6\u9891\u91cd\u7ed8\n- `create_task_video_edit`: \u5c40\u90e8\u7f16\u8f91\n- `create_task_video_extension`: \u89c6\u9891\u5ef6\u5c55\n- `create_task_video_expansion`: \u89c6\u9891\u753b\u9762\u6269\u5c55\n\n### \u67e5\u8be2\u7ed3\u679c\u5de5\u5177\n\n- `get_task_result`: \u6839\u636e\u4efb\u52a1ID\u67e5\u8be2\u5904\u7406\u7ed3\u679c\n\n## \u9519\u8bef\u5904\u7406\n\n\u670d\u52a1\u5668\u4f1a\u81ea\u52a8\u5904\u7406\u4ee5\u4e0b\u9519\u8bef\u60c5\u51b5\uff1a\n- API\u5bc6\u94a5\u65e0\u6548\u6216\u7f3a\u5931\n- \u7f51\u7edc\u8fde\u63a5\u95ee\u9898\n- \u53c2\u6570\u9a8c\u8bc1\u9519\u8bef\n- \u4efb\u52a1\u5904\u7406\u5931\u8d25\n\n## \u5f00\u53d1\n\n### \u5b89\u88c5\u5f00\u53d1\u4f9d\u8d56\n\n```bash\npip install -e \".[dev]\"\n```\n\n### \u8fd0\u884c\u6d4b\u8bd5\n\n```bash\npytest\n```\n\n### \u4ee3\u7801\u683c\u5f0f\u5316\n\n```bash\nblack .\nisort .\n```\n\n## \u8bb8\u53ef\u8bc1\n\nMIT License\n\n## \u76f8\u5173\u94fe\u63a5\n\n- [\u963f\u91cc\u4e91\u767e\u70bc\u5b98\u65b9\u6587\u6863](https://help.aliyun.com/zh/model-studio/)\n- [\u89c6\u9891\u751f\u6210API\u6587\u6863](https://help.aliyun.com/zh/model-studio/video-generation-api/)\n- [MCP\u534f\u8bae\u89c4\u8303](https://github.com/modelcontextprotocol/specification)\n",
"bugtrack_url": null,
"license": null,
"summary": "\u963f\u91cc\u4e91\u767e\u70bc-\u901a\u4e49\u4e07\u76f8\u89c6\u9891\u7f16\u8f91\u7edf\u4e00\u6a21\u578bMCP\u670d\u52a1\u5668",
"version": "1.0.4",
"project_urls": {
"Bug Tracker": "https://github.com/johnchen/mcp-server-bailian-video-synthesis/issues",
"Documentation": "https://github.com/johnchen/mcp-server-bailian-video-synthesis#readme",
"Homepage": "https://github.com/johnchen/mcp-server-bailian-video-synthesis",
"Repository": "https://github.com/johnchen/mcp-server-bailian-video-synthesis"
},
"split_keywords": [
"mcp",
" model-context-protocol",
" aliyun",
" bailian",
" video",
" ai"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4803cab8cf12973f72def036fa23e0c6813583ee145569341942147b9fc2dacf",
"md5": "36b8364cb7e1dd53751d5b5944fb5e40",
"sha256": "d810c1a8b031dcc20368289638aa544563fe51f01ad1f15116e4595ced11a259"
},
"downloads": -1,
"filename": "mcp_server_bailian_video_synthesis-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "36b8364cb7e1dd53751d5b5944fb5e40",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 14428,
"upload_time": "2025-08-16T15:04:40",
"upload_time_iso_8601": "2025-08-16T15:04:40.307961Z",
"url": "https://files.pythonhosted.org/packages/48/03/cab8cf12973f72def036fa23e0c6813583ee145569341942147b9fc2dacf/mcp_server_bailian_video_synthesis-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2ab7d189aa6d4f34dafb5e15ab4017c6f637640ac50051135c82a5d62f202ff3",
"md5": "b8a368faea70fa81e3cd53c48961b8bc",
"sha256": "34c1fb47db0f78b61c2870c4239ac408c706628a6d7f01210e62fc03e025300d"
},
"downloads": -1,
"filename": "mcp_server_bailian_video_synthesis-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "b8a368faea70fa81e3cd53c48961b8bc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 17068,
"upload_time": "2025-08-16T15:04:41",
"upload_time_iso_8601": "2025-08-16T15:04:41.372894Z",
"url": "https://files.pythonhosted.org/packages/2a/b7/d189aa6d4f34dafb5e15ab4017c6f637640ac50051135c82a5d62f202ff3/mcp_server_bailian_video_synthesis-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-16 15:04:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "johnchen",
"github_project": "mcp-server-bailian-video-synthesis",
"github_not_found": true,
"lcname": "mcp-server-bailian-video-synthesis"
}
JSON
