# StemLab — timing and loops for Shorts

> StemLab — timing and loops for Shorts is an open-source MCP server for design and media. Local music analysis for stems, beats, lyrics and loopable sections for YouTube Shorts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://kieransimkin.co.uk/my-songs/
- **Repository:** https://github.com/kieransimkin/stemlab
- **MCP Registry name:** io.github.kieransimkin/stemlab
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

StemLab works on audio you keep in a local workspace folder, set with `STEMLAB_CODEX_WORKSPACE`, and does not send files elsewhere. Its README describes analysis of stems, tempo and beats, harmony, lyrics and MIDI, plus finding sections that loop cleanly for Shorts. It is part of the author's DanceFlow tools.

A lot of the documentation concerns lyric timing. Export of canonical LRC files rejects missing anchors and implausibly long phrases, a batch route holds back export when a section fails rather than interpolating lines, and optional passes use local Whisper weights and CTC letter alignment to compare word boundaries. Everything exported stays a draft until the artist confirms by listening, and recognition scores are described as not proof of sung-word accuracy.

Beat finding is marked experimental: tempo estimates keep their original value alongside a refined sub-frame estimate, and are reported as review diagnostics rather than calibrated confidence. The code is MIT licensed; the sample music and artwork are not.

## Features

- **Local-only workspace:** Works inside one directory of audio you authorise and never uses a filesystem root.
- **Lyric timing gates:** LRC export rejects missing anchors and compressed line clusters.
- **Boundary comparison:** Compares onset and release observations and flags disagreement between decodes.
- **Beat and tempo evidence:** Reports predicted beats, observed onsets and tempo families separately.
- **Display-timing drafts:** `lyric-display` proposes when lyric lines appear and clear.
- **Draft status:** Exports remain drafts until the artist confirms by listening.

## Good for

- Align lyrics to a recorded song and review disputed words
- Estimate tempo and beat positions for a track
- Find loopable sections for short-form video
- Separate vocal parts for line timing
- Compare drafted lyric display timing against an authored LRC

## Install

### Claude Code (Terminal)

```sh
claude mcp add stemlab --env STEMLAB_CODEX_WORKSPACE='<STEMLAB_CODEX_WORKSPACE>' -- uvx danceflow-stemlab
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "stemlab": {
      "command": "uvx",
      "args": [
        "danceflow-stemlab"
      ],
      "env": {
        "STEMLAB_CODEX_WORKSPACE": "<STEMLAB_CODEX_WORKSPACE>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "stemlab": {
      "command": "uvx",
      "args": [
        "danceflow-stemlab"
      ],
      "env": {
        "STEMLAB_CODEX_WORKSPACE": "<STEMLAB_CODEX_WORKSPACE>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "stemlab": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "danceflow-stemlab"
      ],
      "env": {
        "STEMLAB_CODEX_WORKSPACE": "<STEMLAB_CODEX_WORKSPACE>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "stemlab": {
      "command": "uvx",
      "args": [
        "danceflow-stemlab"
      ],
      "env": {
        "STEMLAB_CODEX_WORKSPACE": "<STEMLAB_CODEX_WORKSPACE>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "stemlab": {
      "command": "uvx",
      "args": [
        "danceflow-stemlab"
      ],
      "env": {
        "STEMLAB_CODEX_WORKSPACE": "<STEMLAB_CODEX_WORKSPACE>"
      }
    }
  }
}
```

## FAQ

### Where does the processing happen?

Locally; the server reads a workspace directory you set in an environment variable.

### What license is it under?

MIT for the code. The bundled music and artwork are not licensed under it.

### Are lyric exports final?

No, the README calls them drafts until the artist confirms by listening.

### How is it installed?

As the `danceflow-stemlab` package from PyPI, over stdio.

### Is StemLab — timing and loops for Shorts free?

Yes. StemLab — timing and loops for Shorts is open source, so you can use and self-host it for free.

### How do I add StemLab — timing and loops for Shorts to Claude Code?

Run this command in your terminal: claude mcp add stemlab --env STEMLAB_CODEX_WORKSPACE='<STEMLAB_CODEX_WORKSPACE>' -- uvx danceflow-stemlab

### What are the best alternatives to StemLab — timing and loops for Shorts?

The closest alternatives to StemLab — timing and loops for Shorts are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/stemlab-timing-and-loops-for-shorts
