# Tennis Evolution

> Tennis Evolution is a freemium MCP server for sports data. Turn a long tennis recording into a labeled highlight reel of the longest rallies. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://tennis-evolution.pages.dev
- **Repository:** https://github.com/bobobo2026/tennis-evolution
- **MCP Registry name:** io.github.bobobo2026/tennis-evolution
- **Categories:** sports data, design and media
- **Listing updated:** 2026-11-14

## About

Tennis Evolution takes a phone recording and a list of highlight time ranges, then cuts each rally, burns the hit count, venue, wall-clock time and source timestamp onto the picture and checks the result. Detection is deliberately left out of scope: the list can come from another tool such as sliceapp, your own detector or a typed text file. The reference run turned a 47 minute 29 second iPhone take with 131 rallies into a 3 minute 49 second reel of the five longest, topping out at a 40-hit rally.

Clips are cut on keyframes as lossless stream copies, which keeps 10-bit HDR and rotation metadata, while the reel is assembled in one trim-and-concat encode because the author found the concat-demuxer shortcut caused an audio offset and broken HEVC frames. Each output is verified for clean decode, zero start offset, matching audio and video duration, non-black first and last frames and non-silent audio, and a failure gives a non-zero exit code.

It is MIT licensed and local-first with no upload or account, and works through a CLI, a local web page or the MCP server started with `uvx tennis-evolution mcp`. It needs ffmpeg. The free version keeps 5 rallies per reel; Pro is a one-time $19.

## Features

- **Lossless rally clips:** Keyframe-aligned stream copies that keep HDR and rotation metadata.
- **Burned-in labels:** Hit count, venue, clock time and source timestamp on every segment.
- **Self-checks:** Nine pass/fail checks per file before a reel counts as done.
- **Bring-your-own highlights:** Accepts time ranges from text, JSON or sliceapp exports.
- **Sorting and limits:** Keep the top N rallies sorted by hits, then length, then time.
- **Local web page:** A localhost interface with progress and downloads.

## Good for

- Cut the longest rallies from an hour of court footage
- Share a labeled reel with hit counts for a club session
- Keep iPhone HDR quality in highlight clips
- Script reel creation from an AI agent
- Check a rendered reel automatically before sharing

## Install

### Claude Code (Terminal)

```sh
claude mcp add tennis-evolution -- uvx tennis-evolution
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tennis-evolution": {
      "command": "uvx",
      "args": [
        "tennis-evolution"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tennis-evolution": {
      "command": "uvx",
      "args": [
        "tennis-evolution"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "tennis-evolution": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tennis-evolution"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tennis-evolution": {
      "command": "uvx",
      "args": [
        "tennis-evolution"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tennis-evolution": {
      "command": "uvx",
      "args": [
        "tennis-evolution"
      ]
    }
  }
}
```

## FAQ

### Does my footage leave my machine?

No. The site says there is no upload, no account and no cloud.

### What does it cost?

Free for 5 rallies per reel; Pro is a one-time $19 payment for every rally with no watermark.

### Does it detect rallies itself?

No. Detection is out of scope; you supply time ranges from another tool or a text file.

### What do I need installed?

Python 3.11 or newer and ffmpeg and ffprobe.

### Is Tennis Evolution free?

Tennis Evolution has a free plan, with paid plans for more usage or features.

### How do I add Tennis Evolution to Claude Code?

Run this command in your terminal: claude mcp add tennis-evolution -- uvx tennis-evolution

### What are the best alternatives to Tennis Evolution?

The closest alternatives to Tennis Evolution 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/tennis-evolution
