Skip to main content
Glama
1000ri-jp

atsurae

by 1000ri-jp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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.

License: MIT Python 3.11+ MCP Compatible

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.

Related MCP server: ViralSpin MCP

Features — 10 MCP Tools

Tool

Description

atsurae_inspect

View project state at 3 detail levels: L1 summary, L2 structure, L3 full timeline

atsurae_edit

Add, move, trim, transform, and delete clips on the timeline

atsurae_audio

Manage audio tracks — volume, ducking, BGM, narration

atsurae_semantic

High-level operations: close_all_gaps, snap_to_previous, reorder_clips

atsurae_batch

Execute up to 20 operations atomically in a single call

atsurae_preview

Get visual preview frames, event points, and before/after diffs

atsurae_analyze

Quality analysis — detect gaps, pacing issues, composition problems

atsurae_render

Start, monitor, and download video renders

atsurae_history

View operation history and rollback changes

atsurae_pipeline

End-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.

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers