Metadata-Version: 2.4
Name: nira-video-mcp
Version: 1.0.2
Summary: NIRA Video Production MCP — professional video editing, grading, AI generation, and delivery (55 tools)
Project-URL: Homepage, https://github.com/pachote/nira-video-mcp
Project-URL: Repository, https://github.com/pachote/nira-video-mcp
Project-URL: Bug Tracker, https://github.com/pachote/nira-video-mcp/issues
Author-email: pachote <beatsyncpro.official@gmail.com>
License: MIT
Keywords: ai-video,claude,color-grading,ffmpeg,mcp,production,video
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: fal-client>=0.5.0
Requires-Dist: mcp[cli]>=1.27.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# NIRA Video MCP — 55 Video Production Tools for Claude

<!-- mcp-name: io.github.pachote/nira-video-mcp -->

**The most complete video production MCP.** Edit, grade, generate AI video, master audio, generate TTS captions, and deliver to any platform — all from a Claude conversation.

```
pip install nira-video-mcp
```

[![PyPI version](https://img.shields.io/pypi/v/nira-video-mcp.svg)](https://pypi.org/project/nira-video-mcp/)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.pachote%2Fnira--video--mcp-green)](https://registry.modelcontextprotocol.io)

---

## What you can do

**From a single Claude prompt:**

> *"Trim clip.mp4 to 30 seconds, apply a cinematic teal-orange grade, normalize audio to -14 LUFS, add my logo in the bottom right, and export for YouTube 1080p"*

> *"Generate a 5-second aerial shot of a neon city at night using Kling 3.0, then apply vintage film grain and export for TikTok"*

> *"Create a project from 6 clips with crossfade transitions, add background music at 20% volume, burn in subtitles from transcript.srt, render at ProRes 4444"*

---

## 55 Tools Across 9 Modules

| Module | Tools |
|--------|-------|
| **Inspect** | `vid_inspect` `vid_probe` `vid_thumbnail` `vid_list_workspace` `vid_waveform` |
| **Edit** | `vid_trim` `vid_concat` `vid_resize` `vid_speed` `vid_filter` `vid_overlay` `vid_loop` `vid_reverse` `vid_stabilize` `vid_transition` |
| **Grade** | `vid_grade` `vid_lut` `vid_grain` `vid_vignette` `vid_chromakey` `vid_glitch` `vid_halation` `vid_motion_blur` |
| **Audio** | `aud_extract` `aud_replace` `aud_normalize` `aud_mix` `aud_add_music` `aud_silence` `aud_master` `aud_duck_smart` `aud_detect_beats` `vid_tts_caption` |
| **Motion Graphics** | `vid_text_overlay` `vid_lower_third` `vid_title_card` `vid_subtitles` `vid_progress_bar` `vid_manim_render` |
| **AI Generation** ⭐ PRO | `ai_gen_wan2gp` `ai_gen_fal` `ai_gen_status` `ai_gen_cancel` `ai_gen_list_models` |
| **Delivery** | `vid_export` `vid_export_hls`⭐ `vid_thumbnail_sprite`⭐ `vid_chapters` `vid_metadata` |
| **Projects** | `proj_create` `proj_list` `proj_render` |
| **Render Queue** | `render_status` `render_cancel` `render_list` |

⭐ = PRO tier

---

## Quick Install

**Option 1 — pip (recommended):**

```bash
pip install nira-video-mcp
```

Add to Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "nira-video-mcp": {
      "command": "nira-video-mcp",
      "env": {
        "VIDPROD_OUTPUT": "/path/to/output",
        "VIDPROD_INPUT": "/path/to/clips",
        "FAL_KEY": "your-fal-key"
      }
    }
  }
}
```

**Option 2 — Claude Code:**

```bash
claude mcp add nira-video-mcp nira-video-mcp \
  --env VIDPROD_OUTPUT="/path/to/output" \
  --env VIDPROD_INPUT="/path/to/clips"
```

**Requirements:** Python 3.11+ · [FFmpeg](https://ffmpeg.org/download.html) in PATH

---

## AI Video Generation (PRO)

Generate real video clips from text or image prompts — directly from Claude:

| Model | Provider | Cost/sec | Best for |
|-------|----------|----------|----------|
| Wan2GP | Local GPU | **Free** | Privacy, NSFW, unlimited |
| Kling 3.0 | fal.ai | $0.084 | Best value, 5-10s clips |
| Luma Ray3 | fal.ai | $0.08 | Best image-to-video |
| Veo 3.1 | fal.ai | $0.40 | Highest quality + audio |
| MiniMax Hailuo 2.3 | fal.ai | $0.015 | Cheapest, high volume |
| Pika 2.2 | fal.ai | $0.05 | Fast loops from image |

```
> "Generate a 5-second slow motion shot of waves crashing on rocks, 
   cinematic, golden hour lighting, using Kling 3.0"
```

Unlock AI generation: **[NIRA Video MCP PRO — $49 one-time →](https://payhip.com/b/krNB1)**

---

## Color Grading

8 built-in cinematic looks:

| Look | Description |
|------|-------------|
| `teal_orange` | Hollywood blockbuster — teal shadows, warm highlights |
| `vintage_film` | Faded film stock with lifted blacks |
| `noir` | High-contrast black and white |
| `golden_hour` | Warm amber summer light |
| `cold_blue` | Desaturated thriller/crime aesthetic |
| `blockbuster` | Vibrant, punchy streaming look |
| `sunset_warm` | Rich oranges and deep shadows |
| `moody_green` | Matrix/Fincher desaturated green tint |

Plus: custom `.cube` LUT support, VHS/glitch, film halation, chromakey, motion blur.

---

## Delivery Presets

15 platform presets with correct specs for every major platform:

`youtube_4k` `youtube_1080` `youtube_shorts` `tiktok` `instagram_reels` `instagram_feed` `twitter` `facebook` `linkedin` `prores_4444` `prores_422` `h265_4k` `av1_web` `gif` `web_mp4`

---

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `VIDPROD_OUTPUT` | `~/video_output` | Output directory |
| `VIDPROD_INPUT` | `~/video_input` | Input clips directory |
| `VIDPROD_WORKSPACE` | `~/video_workspace` | Projects directory |
| `FAL_KEY` | — | fal.ai key for cloud AI gen |
| `WAN2GP_PATH` | `D:/Wan2GP` | Wan2GP install path |
| `NIRA_PRO_KEY` | — | PRO license key |

---

## PRO License

**[Get NIRA Video MCP PRO — $49 one-time](https://payhip.com/b/krNB1)**

PRO unlocks:
- All 5 AI video generation tools (Wan2GP + fal.ai: Kling, Luma, Veo, MiniMax, Pika)
- HLS adaptive streaming export (`vid_export_hls`)
- Thumbnail sprite generation (`vid_thumbnail_sprite`)

Set your key:
```bash
export NIRA_PRO_KEY=your-license-key
```

Or in `claude_desktop_config.json`:
```json
"NIRA_PRO_KEY": "your-license-key"
```

---

## License

MIT — free to use, modify, redistribute. PRO features require a license key.

---

*Built with [FastMCP](https://github.com/jlowin/fastmcp) · Powered by FFmpeg · AI generation via [fal.ai](https://fal.ai) and [Wan2GP](https://github.com/wan-video/Wan2GP)*
