English Français العربية

Atsurae

Communauté Médias et design

Video editing: timeline editing, five-layer compositing, semantic operations and FFmpeg rendering to 1080p H.264.

Code source Documentation

Installation

Les étapes d'installation sont dans la documentation ci-dessous. Documentation

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. atsurae
  2. Quick Start
  3. Features — 10 MCP Tools
  4. Example
  5. Architecture
  6. API
  7. Development
  8. Contributing
  9. License

atsurae

AIが、あつらえる — AI-crafted video editing

MCP Server for AI-powered video editing. Let Claude, GPT, or any AI agent edit videos through natural language.

Quick Start

# Install with pip
pip install atsurae

# Or with uv
uv pip install atsurae
Claude Desktop Configuration

Add to your Claude Desktop config (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"
      }
    }
  }
}

Then restart Claude Desktop. You can now edit videos through conversation.

Features — 10 MCP Tools

ToolDescription
atsurae_inspectView project state at 3 detail levels: L1 summary, L2 structure, L3 full timeline
atsurae_editAdd, move, trim, transform, and delete clips on the timeline
atsurae_audioManage audio tracks — volume, ducking, BGM, narration
atsurae_semanticHigh-level operations: close_all_gaps, snap_to_previous, reorder_clips
atsurae_batchExecute up to 20 operations atomically in a single call
atsurae_previewGet visual preview frames, event points, and before/after diffs
atsurae_analyzeQuality analysis — detect gaps, pacing issues, composition problems
atsurae_renderStart, monitor, and download video renders
atsurae_historyView operation history and rollback changes
atsurae_pipelineEnd-to-end AI video creation pipeline

Example

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

Architecture

                    MCP Protocol                 REST API
[You / AI Agent] ──────────────→ [atsurae MCP] ──────────→ [atsurae.ai API]
                                   Server                        │
                                                                 ▼
                                                          [Video Engine]
                                                                 │
                                                                 ▼
                                                          [FFmpeg Render]
                                                                 │
                                                                 ▼
                                                           [Output MP4]

Layer Compositing Model:

L5: Telop / Text overlays
L4: Effects (particles, transitions)
L3: Avatar (chroma-keyed)
L2: Screen capture / Slides
L1: Background (3D space, gradients)

Output: 1920x1080, 30fps, H.264 + AAC, MP4

API

atsurae.ai also exposes a REST API that any AI agent can call directly, without MCP.

Documentation: https://docs.atsurae.ai (coming soon)

Development

# 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

Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change.

License

MIT

atsurae is built by 1000ri-jp.

AIが、あつらえる — AI crafts it for you.

Questions fréquentes

Qu'est-ce que Atsurae ?

Video editing: timeline editing, five-layer compositing, semantic operations and FFmpeg rendering to 1080p H.264.

Comment installer Atsurae ?

Suivez les étapes d'installation de sa documentation, affichée sur cette page et dans son dépôt.

Atsurae est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Atsurae ?

Il est publié par 1000ri-jp. AI.tn le référence sans le maintenir ni le recommander.

Issu des listes communautaires awesome-mcp-servers et du dépôt GitHub du projet. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.