# jevreel

> jevreel is an open-source MCP server for design and media. Find and verify moments in video using contact sheets and a decision model, no embeddings. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/deepaleph/jevreel
- **MCP Registry name:** io.github.DeepAleph/jevreel
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

jevreel lays a video out on labelled contact sheets of 60 frames each, sampled at one frame per second, and has Jev, TypeSafe's decision model, judge every sheet in parallel. The best windows are rechecked on full frames every half second, and the agent gets back moments, times and probabilities, then looks closer itself. No vectors are computed or stored.

Because questions are asked at search time, the same index can answer a yes/no with the second it happens, pick one of your own options, or score a level, per minute or for the whole film. Custom lenses add typed questions to every minute at little extra cost, and the README shows searching dialogue from captions, reading on-screen text and finding a person from a reference photo. Answers are cached.

It needs Python 3.11 or newer, FFmpeg and a TypeSafe API key, and costs depend on Jev: the README quotes roughly $0.02 to $0.03 per hour of video screened. It says embeddings suit repeated queries over a large library better, and the two can be combined.

## Features

- **Contact-sheet screening:** Checks every second of video using 60-frame labelled sheets.
- **Full-frame verification:** Rechecks top windows half a second apart.
- **Typed questions:** Supports yes/no, choice and score questions per minute.
- **Custom lenses:** Adds your own questions to every minute of the index.
- **Photo search:** Finds a person or object from a reference image.
- **Dialogue search:** Uses captions or local speech-to-text.

## Good for

- Find the moment someone does a specific thing in a video
- Search what is said in a recording
- Read on-screen text such as a headline
- List every scene a character appears in

## Install

### Claude Code (Terminal)

```sh
claude mcp add jevreel --env TYPESAFE_API_KEY='<TYPESAFE_API_KEY>' -- uvx jevreel
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "jevreel": {
      "command": "uvx",
      "args": [
        "jevreel"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jevreel": {
      "command": "uvx",
      "args": [
        "jevreel"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "jevreel": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "jevreel"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jevreel": {
      "command": "uvx",
      "args": [
        "jevreel"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jevreel": {
      "command": "uvx",
      "args": [
        "jevreel"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Does it use embeddings?

No, it uses a decision model and stores no vectors.

### What do I need installed?

Python 3.11 or newer, FFmpeg and a TypeSafe API key.

### What does it cost?

The README quotes about $0.02 to $0.03 per hour of video screened, paid to TypeSafe for Jev.

### When are embeddings better?

For repeated queries over a large library, since each lookup is then free.

### Is jevreel free?

Yes. jevreel is open source, so you can use and self-host it for free.

### How do I add jevreel to Claude Code?

Run this command in your terminal: claude mcp add jevreel --env TYPESAFE_API_KEY='<TYPESAFE_API_KEY>' -- uvx jevreel

### What are the best alternatives to jevreel?

The closest alternatives to jevreel are HyperFrames by HeyGen, headroom, omniget, next-ai-draw-io and mcp-for-blender.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [headroom](https://ai-powered.com/mcp/headroom-3): headroom is an open-source MCP server for ai models and llm tooling.
- [omniget](https://ai-powered.com/mcp/omniget): omniget is an open-source MCP server for ai models and llm tooling.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source 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.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/jevreel
