podcli MCP server
Commit 3. Nov. 2026Verwandelt lange Podcast-Episoden mithilfe eines AI Agents in kurze vertikale Clips mit Face Tracking und eingebetteten Untertiteln.
Auch bekannt als nmbrthirteen/podcli
- Stars
- 89
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 3. Nov. 2026
- Lizenz
- AGPL-3.0
Was ist podcli MCP?
podcli ist ein MCP server. Verwandelt lange Podcast-Episoden mithilfe eines AI Agents in kurze vertikale Clips mit Face Tracking und eingebetteten Untertiteln.
Zusammenfassung generiert aus dem README des Projekts
Über podcli MCP server
podcli ermöglicht es Content Creators, lange Podcast-Episoden in kurze vertikale Clips mit Face Tracking und eingebetteten Untertiteln zu verwandeln. Dieses Open-Source-Tool automatisiert den mühsamen Prozess, Highlights zu finden, das Video so zuzuschneiden, dass den Sprechern gefolgt wird, und verschiedene Caption-Styles wie Karaoke oder Branding-Layouts hinzuzufügen. Es läuft lokal auf macOS, Linux und Windows, sodass Transkription und Rendering auf deinem eigenen Rechner stattfinden und deine Daten privat bleiben.
Entwickler können mit dem System über ein Command Line Interface, ein webbasiertes Studio unter localhost:3847 oder durch die Verbindung mit einem AI Agent via 32 MCP tools interagieren. Während Transkription und Rendering lokal erfolgen, kann das Clip Scoring einen Anthropic API Key oder einen Claude Code oder Codex Login nutzen. Für fortgeschrittenes Speaker Tracking kann das System mit AssemblyAI integriert werden. Der Server unterstützt komplexe Workflows wie Multicam-Syncing, lautstärkegeregelte Audioausgabe und den Export von Timelines in professionelle Software wie Premiere oder Final Cut.
Was du damit machen kannst
- 1Automatisierte Clip-GenerierungEin Agent kann eine Episode transkribieren und automatisch kurze Clips mit Untertiteln rendern.
- 2Multicam-Episoden-EditingSynchronisiere mehrere Kamera- und Mikrofon-Dateien, um eine professionelle Langformat-Episode zu erstellen.
- 3KI-gestützte Highlight-SucheNutze KI, um die spannendsten Momente anhand eines Transkripts zu bewerten und zu identifizieren.
- 4Professioneller Video-WorkflowExportiere deine Edits als spezialisierte Dateien, um die manuelle Arbeit in DaVinci Resolve abzuschließen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarnmbrthirteen/podcli is public and reachablegithub.com/nmbrthirteen/podcli ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-03github.com/nmbrthirteen/podcli ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenpodcli process episode.mp4
That one command transcribes the episode, picks the moments worth clipping, crops to the visible face, and burns the captions in. Transcription and rendering run on your machine. Clip scoring uses Claude Code or Codex login, or an Anthropic API key; without those it falls back to heuristics.
Install
No prerequisites. The installer fetches a self-contained binary, and the first run provisions Python, Node, FFmpeg, whisper.cpp, and the models it needs into a managed folder.
macOS and Linux
curl -fsSL https://podcli.com/install.sh | sh
Windows (PowerShell)
irm https://podcli.com/install.ps1 | iex
Runs on macOS (Apple Silicon), Linux (x64 and arm64), and Windows (x64). Intel Macs aren't supported.
Quick start
podcli # interactive menu, opens the web studio
podcli process episode.mp4 # transcribe, pick moments, render clips
podcli multicam ~/ep12 # sync every camera and mic, cut to the speaker, render the episode
Clips land in podcli-clips/ in the directory you ran it from, so each show keeps its own renders. Everything else (knowledge, presets, assets, clip history, cache) lives in one managed folder that follows you between directories. Set PODCLI_OUTPUT to render somewhere fixed instead.
What you get
Clips
- 9:16, 16:9, or 1:1, with captions sized for each canvas
- Face tracking that follows the visible face, split-screen layouts included. Following the active speaker needs AssemblyAI, or a source install with openai-whisper and
HF_TOKEN - Multi-segment cuts that drop filler, long pauses, and tangents
- Four caption styles: branded, hormozi, karaoke, subtle
- Logos, intros, outros, and background music from a reusable asset library
- Loudness-normalized audio and hardware encoding on VideoToolbox and NVENC, with a CPU fallback
Editing the full episode
- Multicam edit: point at one folder of camera and mic files, confirm who each file belongs to, and podcli syncs them by audio and corrects clock drift between devices
- Automatic camera cuts that follow whoever is talking, with wide shots for crosstalk and a guest's answer held on the guest
- Remote shows too: one file per person becomes a split screen, and a single gallery recording is split into a camera per tile. Questions stay on the split and the guest goes full frame on long answers
- Render the episode as an MP4 with one WAV per person. Studio shoots can also go to Premiere or Final Cut as a timeline that points at your original files
- Same edit from the studio (Multicam edit), the CLI (
podcli multicam <folder>), or an agent (manage_multicam). Re-running reuses the sync and the cut, so only the step you changed runs again - With podcli Pro, steer the cut in the cloud editor:
podcli multicam <folder> --clouduploads per-camera proxies, a mic mix (about 550 MB for a two-hour, three-camera episode), and the transcript. Your original camera files stay on your computer, and--pullrenders the cut you made there
Finding the moments
- Whisper transcription (speaker diarization on AssemblyAI, or openai-whisper from a source install or
podcli setup --speakers), or bring your own transcript as.txt,.srt, or.vtt - AssemblyAI as an alternative engine, and yt-dlp to pull an episode straight from a URL
- AI scoring against your knowledge base, checked against your episode database so it stops resuggesting moments you already published
- Audio energy and laughter detection to build highlight reels
The studio at localhost:3847
- Library, episode workspace, multicam edit, per-clip detail, highlights, thumbnails, content, analytics, assets, knowledge, config, integrations, and MCP setup
⌘Kcommand palette across pages, clips, and assets- Titles, descriptions, tags, and hashtags, with any section regenerated on your own guidance
- Thumbnail studio for 16:9 and 9:16, with frame and text options
- Transcript corrections that carry through to every render
Shipping it
- 32 MCP tools, so an agent can transcribe, score, and render through conversation
- YouTube analytics to see which clips landed
- DaVinci Resolve export as FCPXML when you want to finish by hand
- Presets, clip history with duplicate detection, and a transcript cache
Why podcli
If you are weighing podcli against the cloud clippers, this is the difference:
- Runs locally. Transcription and rendering happen on your machine by default, so episodes stay there. Data leaves your machine only through these destinations:
- AssemblyAI, if you pick that engine: the episode audio.
- AI scoring and titles: the transcript goes to podcli Pro when you are signed in, to Anthropic when you set
ANTHROPIC_API_KEY, and to the provider behind your Claude Code or Codex login. - podcli Pro, when signed in: knowledge and asset sync, plus rendered clips and transcript slices if you turn on
PODCLI_CLOUD_SYNC=1(off by default). - YouTube, if you link it: read-only analytics requests.
- podcli multicam cloud, if you run
podcli multicam --cloud: per-camera proxies, a mic mix, and the transcript.
- Free and open source under AGPL-3.0. Exports are unlimited, full quality, and watermark-free.
- Agent-native. 32 MCP tools let Claude Code or Codex drive the whole flow, from transcription to rendered clips and publish-ready titles.
- A knowledge base keeps titles, captions, and descriptions in your show's voice, and stops the engine from resuggesting moments you already published.
- DaVinci Resolve handoff. Export any clip as FCPXML when you want to finish the edit yourself.
Use it from your agent
podcli is an MCP server, so an agent can transcribe, suggest clips, and render them through conversation.
podcli mcp install # registers it with Claude Code and Codex, whichever CLI is on PATH
--help and --version never download anything. First run of process, studio, transcribe, or multicam provisions the engine. podcli mcp does not, because stdout is JSON-RPC. Run podcli setup once before you point an agent at it.
podcli process episode.mp4 --json --yes
podcli doctor --json
--json writes one object to stdout and logs to stderr. -y/--yes skips prompts. NO_COLOR=1 (or a non-TTY) turns off colour and spinners.
rank_clip_candidates returns a shortlist so the agent does not have to read the whole transcript. process_episode runs the pipeline as one job; poll it with job_status. The workflow lives in SKILL.md. Tool names are generated into llms.txt.
Claude Desktop and Codex setup is in the MCP docs.
Content workflow
PodStack ships with podcli as a set of Claude Code slash commands. They take a transcript to a publish-ready package: scored moments, titles, descriptions, thumbnail briefs, a brand review, and a publish checklist.
/produce-shorts
The commands live in .claude/commands/. CLAUDE.md describes each one.
Docs
| Guide | What's in it |
|---|---|
| Getting started | Install, first episode, the whole flow |
| The studio | Web UI: library, episodes, content, highlights |
| CLI | Commands, flags, presets, assets |
| MCP server | Agent setup and available tools |
| Captions and formats | Styles, aspect ratios, cropping |
| Configuration | Environment variables, config profiles, transcript format |
Docs are open source at nmbrthirteen/podcli-docs.
Contributing
See CONTRIBUTING.md for the dev setup and conventions, and RELEASE.md for how releases are cut.
Credits
Content workflow powered by PodStack, inspired by gstack by Garry Tan.
License
AGPL-3.0. See LICENSE.
Need podcli without AGPL terms? A commercial license is available. Email siradze@nikusha.me with a one-line description of your use case.
podcli MCP Fragen
Was macht podcli?
Es transkribiert eine Podcast-Episode, wählt die lohnenswerten Momente für Clips aus, schneidet das Video auf das sichtbare Gesicht zu und brennt Untertitel ein, um kurze Clips zu erstellen.
Wie verbinde ich podcli mit Claude Code oder Codex?
Führe nach einem einmaligen podcli setup den Befehl podcli mcp install aus; dieser registriert den MCP server bei dem CLI, das in deinem PATH liegt.
Läuft podcli lokal oder in der Cloud?
Transkription und Rendering laufen standardmäßig auf deinem Rechner; Cloud-Aufrufe erfolgen nur für optionale Dienste wie AI Scoring, AssemblyAI oder podcli Pro.
Wie viele MCP tools stellt podcli bereit?
Es stellt 32 MCP tools bereit, mit denen ein Agent durch einfache Konversation transkribieren, bewerten und Clips rendern kann.
Ist podcli kostenlos und Open Source?
Ja, podcli wird unter der AGPL-3.0 Lizenz mit unbegrenzten, wasserzeichenfreien Exporten veröffentlicht; eine kommerzielle Lizenz ist auf Anfrage erhältlich.