mediasense

Name: mediasense
Author: joaoestella

作者：joaoestella版本 0.5.1i★ –i在你的电脑上运行

注册名称io.github.joaoestella/mediasense

安装

概览

作者提供的说明（英文原文）

Let Claude listen to audio and watch video: transcribe, summarize and edit recordings and links.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i非常新↓ 309/周 · ★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 设计、图片与音频

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： MEDIASENSE_COOKIES_FROM_BROWSER

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "mediasense": {
      "command": "uvx",
      "args": [
        "mediasense",
        "mcp"
      ],
      "env": {
        "MEDIASENSE_COOKIES_FROM_BROWSER": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add mediasense --env MEDIASENSE_COOKIES_FROM_BROWSER=your-value -- uvx mediasense mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "mediasense": {
      "command": "uvx",
      "args": [
        "mediasense",
        "mcp"
      ],
      "env": {
        "MEDIASENSE_COOKIES_FROM_BROWSER": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "mediasense": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mediasense",
        "mcp"
      ],
      "env": {
        "MEDIASENSE_COOKIES_FROM_BROWSER": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

MEDIASENSE_COOKIES_FROM_BROWSER env
Optional: browser to read cookies from (chrome, firefox, edge…) for links that need a login.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 joaoestella 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“设计、图片与音频”中的其他服务器比较i

星标数多于此分类中其他 2787 个服务器的 0%
发布到注册中心的时间比此分类中其他 2787 个服务器的 96% 更新
基础检查结果等于或优于此分类中其他 2787 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

mediasense 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.5.1）于昨天进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它？

同一分类中有：Figma Context MCP, Claude Real Video, Figma MCP Server

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Figma Context MCP

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

作者：GLips广泛使用↓ 16.1万/周★ 1.6万5个月前更新

在你的电脑上运行

安装

Claude Real Video

Let any LLM watch a video locally — and search everything it has ever watched.

作者：HUANGCHIHHUNGLeo广泛使用↓ 1106/周★ 22842个月前更新

在你的电脑上运行

安装

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

作者：figma正在增长★ 215213个月前更新

在云端运行✓ mcp.figma.com

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

mediasense

Give Claude ears and eyes. Claude can't listen to audio or watch videos on its own; with mediasense it can. Point at a voice message, podcast, recording or meeting, or paste a TikTok, YouTube or Instagram link, in Claude Code or Claude Desktop and ask in plain language. Claude can then transcribe it, summarize it, explain what happens, find the moment something is said, or edit it.

you: what does this voice message say? ~/Downloads/audio-from-maria.opus

you: summarize this https://www.tiktok.com/@someone/video/7350… you: what does he show at 0:30? and what tool is he talking about? you: clean up ~/Desktop/podcast.m4a — remove the "um"s and long pauses you: make short captions for ~/Videos/reel.mp4 you: put intro.mp3 under the first 5 seconds of talk.mp4, ducked

Real output for a 17-second TikTok by @elim.doc, shown with the creator's permission. Regenerate the animation with python docs/make_demo.py.

mediasense runs on your computer: it downloads the link, transcribes speech in ~99 languages with a timestamp for every word, picks key frames at scene changes, and hands Claude a transcript, a shot list and contact-sheet images. Nothing is uploaded anywhere.

Português 🇧🇷

Setup

Windows – paste in PowerShell:

irm https://raw.githubusercontent.com/joaoestella/mediasense/main/install.ps1 | iex

macOS / Linux – paste in a terminal:

curl -LsSf https://raw.githubusercontent.com/joaoestella/mediasense/main/install.sh | sh

Then quit Claude Desktop completely (tray/menu-bar icon → Quit), open it again and ask *"summarize this video: "*. The first transcription downloads the speech model (≈ 500 MB).

Prefer to read the script before running it?

irm https://raw.githubusercontent.com/joaoestella/mediasense/main/install.ps1 -OutFile install.ps1

notepad install.ps1 powershell -ExecutionPolicy Bypass -File .\install.ps1

(macOS/Linux: curl -LsSfO …/install.sh, read it, then sh install.sh.)

The installer only installs what is missing — Python 3.12 and FFmpeg via winget (Homebrew/apt on macOS/Linux) and pipx via pip — then pipx installs mediasense from this repository and runs mediasense setup. It stops at the first failed step.

Manual setup (no script)

winget install ffmpeg                    # macOS: brew install ffmpeg · Linux: sudo apt install ffmpeg

python -m pip install --user pipx python -m pipx ensurepath # then close and reopen the terminal python -m pipx install "mediasense[all]" mediasense setup -n # preview what setup will change mediasense setup mediasense doctor

Use python -m pipx … rather than plain pipx right after installing it: the pipx command only appears on PATH in a new terminal. No Git needed.

As a Claude plugin (skill + server in one)

The repository is also a Claude plugin: installing it adds both the mediasense tools and the skill that tells Claude when to use them. It starts the server with uv, so install uv first (winget install astral-sh.uv · brew install uv · curl -LsSf https://astral.sh/uv/install.sh | sh) plus FFmpeg if you don't have it.

In Claude Code:

/plugin install mediasense --marketplace joaoestella/mediasense

Any other MCP client (Cursor, VS Code, Windsurf…)

mediasense is a standard stdio MCP server, also listed in the official MCP Registry as io.github.joaoestella/mediasense:

{ "mcpServers": { "mediasense": { "command": "uvx", "args": ["mediasense", "mcp"] } } }

Or with a normal install: pipx install mediasense, then use mediasense mcp as the command.

One-click Claude Desktop extension (experimental)

Download [mediasense.mcpb](https://github.com/joaoestella/mediasense/releases/latest/download/mediasense.mcpb) and double-click it (or drag it into Claude Desktop → Settings → Extensions). No Python, pipx or FFmpeg needed: Claude Desktop sets up Python by itself, and FFmpeg is downloaded on first use. The first start takes a few minutes while it installs everything. This uses Claude Desktop's new "UV" extension type, so if it doesn't work on your version, use the installer above.

What `mediasense setup` changes

Claude Desktop: adds one entry, mcpServers.mediasense, to claude_desktop_config.json (%APPDATA%\Claude\ – or %LOCALAPPDATA%\Claude-Data\claude_…\ for the Microsoft Store app – ~/Library/Application Support/Claude/ on macOS, ~/.config/Claude/ on Linux; Claude Desktop → Settings → Developer → Edit Config opens the one your app uses). Everything else in the file is kept, and the previous file is saved next to it as claude_desktop_config.json. .bak. If the file isn't valid JSON, setup stops without touching it.
Claude Code (if installed): runs claude mcp add --scope user mediasense -- \mediasense mcp.
Nothing else. mediasense setup -n shows the exact changes without making them; --desktop or --code limits it to one app. To undo: remove the mediasense entry from the config file and run claude mcp remove mediasense --scope user.

Updating on Windows and pipx says a file "is being used by another process"? Claude Desktop is still running the old server: Get-Process mediasense | Stop-Process -Force, then install again (the installer script does this for you).

Something not working? mediasense doctor checks FFmpeg, the speech model, the GPU, link downloads and the Claude connection.

Teach Claude when to use it (recommended)

mediasense comes with a skill: a short guide that makes Claude reach for mediasense whenever you paste a video link, instead of trying to open the page (TikTok & co. block that).

Claude Code: installed automatically by mediasense setup.
Claude Desktop / claude.ai: download mediasense-skill.zip (the installer also saves it to Downloads/mediasense/), then in Claude open Settings → Skills and upload it. One time only; it syncs to all your devices.

Note: Claude Desktop sends files you attach in the chat to the model, not to your computer, so give

mediasense a link or a file path instead (in Claude Code you can drag the file into the terminal).

Slash commands

The server adds ready-made prompts. In Claude Code they appear as /mcp__mediasense__summarize and so on.

Prompt	Does
`summarize`	gist, key points with timestamps, steps, names and links, call to action
`explain_video`	shot-by-shot explanation, plus how the video is built (hook, structure)
`clean_up`	remove fillers and long pauses, show the plan first, render after your OK
`subtitles`	SRT captions, standard or short 1–3-word style for vertical video

Tools Claude gets

Tool	What it does
`understand_media`	one call: download link, transcribe, key frames + speech per shot, post title/description
`transcribe`	speech → `.transcript.json` with word timestamps; `vocabulary` fixes brand names
`read_transcript`, `search_transcript`	read a time range or find every time a phrase is said
`plan_edit`, `render_edit`	cut phrases, passages, fillers, silences or ranges; preview, then render
`export_transcript`	SRT, VTT, TXT, CSV, JSON
`place_audio`	insert a clip at a timestamp (mix / duck / replace)
`watch_video`, `get_frame`	contact sheets, or one frame at a given time
`media_info`	duration, resolution, fps, streams
`check_job`	result of long work: new videos and the first run reply "still working" and finish in the background

Long work never hits Claude's tool time limit: if a video takes more than ~30 s (a long video on a CPU, or the very first run while the speech model downloads), the tool answers "still working" with a progress percentage and Claude checks back with check_job until it's done.

All tools accept a file path or a link. Links are downloaded once to ~/Downloads/mediasense (change with MEDIASENSE_HOME) and reused.

Command line

Everything also works without Claude:

mediasense understand "https://youtu.be/…"           # transcript + shots + metadata, as text

mediasense transcribe talk.mp4 -l pt --vocab "Cloudflare, Claude" --also srt mediasense search talk.transcript.json "next quarter" mediasense edit talk.mp4 --fillers --silences 0.7 -n # -n = only show the plan mediasense edit talk.mp4 --fillers --silences 0.7 --srt --edl --fcpxml mediasense edit talk.mp4 --cut-between "let me check" "okay so" --cut-range 12:03-12:40 mediasense export talk.transcript.json captions.srt --words-per-cue 2 mediasense place video.mp4 voiceover.wav --at 0:12.5 --mode duck mediasense storyboard reel.mp4 mediasense fetch "https://www.tiktok.com/@…/video/…"

Edits never touch the original: results are written as .edited.* / .placed.*. EDL opens in Premiere, Resolve and Avid; FCPXML in Final Cut Pro and Resolve.

Good to know

Names and jargon. Whisper may write "Cloud Fair" for Cloudflare. Pass --vocab (Claude does this automatically when it can infer the names from the title or the screen).
Fillers. Whisper tends to leave hesitations out; transcribe with --verbatim when you want to cut them. Real words are protected per language ("um" is an article in Portuguese, so it is never cut there). Ambiguous words like "like", "tipo" or "né" are only removed if you list them.
Speed. Everything works on a plain CPU: short clips take seconds, a few minutes of audio takes about as long as the audio with the default small model (base is faster, medium more accurate). No GPU? --backend openai sends the audio to an OpenAI-compatible transcription API instead (fast on any machine, but the audio leaves your computer).
NVIDIA GPU (optional, much faster). mediasense uses it automatically once the CUDA libraries are present; no CUDA toolkit needed:

  python -m pipx inject mediasense nvidia-cublas-cu12 "nvidia-cudnn-cu12>=9,<10" nvidia-cuda-runtime-cu12

(≈ 1.5 GB; needs a driver that supports CUDA 12 – mediasense doctor checks both). Restart Claude Desktop afterwards.

Word timing is approximate (0.1–0.2 s). For tighter cuts and speaker labels use --backend whisperx (pip install "mediasense[whisperx]").
Downloading from links follows each site's terms. Use it for content you're allowed to download.

Privacy Policy

mediasense runs entirely on your computer: no accounts, no analytics, no telemetry, and the author receives no data. It connects to the internet only to download the links you ask about, the speech model (first run), FFmpeg if it's missing, and – only if you choose the openai backend – to send audio to the transcription API you configure. Results stay on your disk until you delete them. When used from Claude, tool results (transcripts, key frames, metadata) are returned to the Clau

只显示了开头部分；其余内容请在仓库中阅读

mediasense

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

需要你填写的值

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“设计、图片与音频”中的其他服务器比较i

常见问题

替代选择

Figma Context MCP

Claude Real Video

Figma MCP Server

作者的 README

mediasense

Setup

What mediasense setup changes

Teach Claude when to use it (recommended)

Slash commands

Tools Claude gets

Command line

Good to know

Privacy Policy

What `mediasense setup` changes