使用说明
atsurae
AI，定做—AI-crafted video editing
用于人工智能视频编辑的MCP服务器。让Claude、GPT或任何AI代理通过自然语言编辑视频。
快速开始
# Install with pip
pip install atsurae
# Or with uv
uv pip install atsurae
Claude桌面配置
添加到您的Claude桌面配置(claude_desktop_config.json):
{
"mcpServers": {
"atsurae": {
"command": "python",
"args": ["-m", "atsurae"],
"env": {
"ATSURAE_API_URL": "https://api.atsurae.ai",
"ATSURAE_API_KEY": "your-api-key"
}
}
}
}
然后重新启动Claude Desktop。您现在可以通过对话编辑视频。
特点——10个MCP工具
| 工具 | 说明 |
|---|---|
atsurae_inspect |
在3个详细级别查看项目状态： L1级 总结， 二级 结构， 三级 完整时间表 |
atsurae_edit |
在时间线上添加、移动、修剪、变换和删除剪辑 |
atsurae_audio |
管理音轨——音量、闪动、背景音乐、旁白 |
atsurae_semantic |
高层运营： close_all_gaps, snap_to_previous, reorder_clips |
atsurae_batch |
在一次调用中原子地执行多达20个操作 |
atsurae_preview |
获取视觉预览帧、事件点和前后差异 |
atsurae_analyze |
质量分析——检测差距、节奏问题、构图问题 |
atsurae_render |
启动、监视和下载视频渲染 |
atsurae_history |
查看操作历史记录和回滚更改 |
atsurae_pipeline |
端到端AI视频创建管道 |
示例
You: Create a 30-second intro video with the uploaded avatar and background music
Claude: I'll create the intro video. Let me inspect the available assets first...
[atsurae_inspect] → Found: avatar.mp4, bgm.mp3, logo.png
[atsurae_edit] → Placed avatar on Layer 3, logo on Layer 5
[atsurae_audio] → Added BGM with -6dB ducking under narration
[atsurae_semantic] → Closed all gaps, snapped clips
[atsurae_analyze] → Quality check passed (no gaps, good pacing)
[atsurae_render] → Rendering at 1080p...
Claude: Your intro video is ready!
Duration: 30s | Resolution: 1920x1080 | Size: 12.4 MB
Download: https://api.atsurae.ai/renders/abc123/output.mp4
建筑
MCP Protocol REST API
[You / AI Agent] ──────────────→ [atsurae MCP] ──────────→ [atsurae.ai API]
Server │
▼
[Video Engine]
│
▼
[FFmpeg Render]
│
▼
[Output MP4]
图层合成模型：
L5: Telop / Text overlays
L4: Effects (particles, transitions)
L3: Avatar (chroma-keyed)
L2: Screen capture / Slides
L1: Background (3D space, gradients)
输出：1920x1080，30fps，H.264+AAC，MP4
API
atsurae.ai还公开了一个REST API，任何ai代理都可以直接调用该API，而无需MCP。
文档： https://docs.atsurae.ai （即将推出）
发展
# Clone
git clone https://github.com/1000ri-jp/atsurae.git
cd atsurae
# Install with dev dependencies
uv pip install -e ".[dev]"
# Run the MCP server locally
python -m atsurae
贡献
欢迎捐款。请先打开一个问题，讨论您想更改的内容。
许可证
atsurae 由建造 1000里/日元.
AI，定做 --AI为你制作。
