# Loom Local MCP Server

MCP server for extracting key frames from Loom videos or local files for debugging analysis.

## Quick Start

```bash
# Build and start the container
./scripts/setup.sh
```

## Usage

### Claude Code Configuration

Add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "loom-agent": {
      "command": "docker",
      "args": ["exec", "-i", "loom-agent", "python", "-m", "loom_agent"]
    }
  }
}
```

### Analyzing Loom Videos

In Claude Code, simply mention a Loom URL:

> "I'm debugging this issue in auth.py. Here's the Loom showing the bug: https://loom.com/share/abc123"

Claude will automatically extract key frames and analyze them.

### Local Video Files

1. Drop video in `~/loom-videos/`
2. Reference by filename:

> "Check out the bug in this recording: bug-demo.mp4"

## Tool Parameters

| Parameter | Default | Description |
|-----------|---------|-------------|
| `source` | required | Loom URL or local filename |
| `threshold` | 0.3 | Scene change sensitivity (0.0-1.0). Lower = more frames |
| `max_frames` | 20 | Maximum frames to extract |

## Directories

- `~/loom-videos/` - Drop local videos here
- `~/loom-frames/` - Extracted frames appear here

## Development

```bash
# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run server locally (without Docker)
python -m loom_agent
```