Media Context Mcp

让 AI 助手拥有眼睛和耳朵。
分析任意视频、音频或图像——完全在本地，直接在编辑器中完成。

安装  ·  功能  ·  模式  ·  示例  ·  工具  ·  选项  ·  文档

大模型可以读取文本、浏览单张图像，却无法观看视频或收听音频。media-context-mcp 填补了这一空白。提供文件或链接，它就会返回简洁、适合模型使用的上下文——关键帧、转录文本或屏幕上的文字——整个过程都在你的设备上完成。不会上传任何内容。

_{10 秒的视频片段会变成一张整洁的联系表，模型可按顺序读取——而不是数百张静帧。}

🚀 安装

只需两步——添加服务，然后安装它所用的本地辅助工具。

1 · 将服务添加到客户端

# Claude Code
claude mcp add media-context -- npx -y media-context-mcp

启动命令始终是 npx -y media-context-mcp。选择你的客户端：

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "servers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "context_servers": {
    "media-context": { "command": { "path": "npx", "args": ["-y", "media-context-mcp"] } }
  }
}

[mcp_servers.media-context]
command = "npx"
args = ["-y", "media-context-mcp"]

**提示：**在 Claude Code 中，你也可以将其作为插件安装——运行 /plugin marketplace add vishalguptax/media-context-mcp，然后运行 /plugin install media-context。如需与团队共享，可按项目安装：使用 --scope project（写入 .mcp.json），或在仓库中提交 .cursor/mcp.json。

2 · 安装本地辅助工具

运行一条命令，通过操作系统的软件包管理器安装服务器使用的所有组件：

npx media-context-mcp setup          # core: keyframes, links, on-screen text
npx media-context-mcp setup --audio  # also enable transcription

之后服务器会自动找到这些辅助工具，无需额外配置。运行 check_media_deps 查看哪些工具已就绪，运行 setup --uninstall 将其移除。(手动安装 →)

3 · 提问

“总结一下 demo.mp4。”

✨ 功能

🎞️ 模式

analyze_media 会自动检测音频和图像。对于视频，可选择帧采样方式：

💬 示例

用自然语言提问即可——助手会选择合适的选项。

🧰 工具

每次调用都在本地运行，并在结束后清理。

⚙️ 选项

助手会为你填写这些选项，但你也可以对它进行引导（“使用胶片条模式”“裁剪到工具栏”）。

❓ 常见问题

大模型能观看视频吗？ 不能直接观看 — 模型处理的是图像和文本，而不是视频。此服务会将视频转换为模型可读取的帧和转录文本。

会上传任何内容吗？ 不会。一切都在你的计算机上运行；无需密钥，也不使用云服务。

哪些客户端可以使用？ 任何 MCP 客户端均可 — Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Cline、Kiro、Gemini CLI、JetBrains、Zed、Codex。

可以处理 YouTube 和其他链接吗？ 可以。

费用是多少？ 免费且开源。

📋 要求

Node.js 18+，支持 Windows、macOS 或 Linux。只需运行一次 npx media-context-mcp setup，即可安装其他所有内容。

🛠️ 开发

npm install
npm run build
npm test

欢迎提交问题和 PR — 架构说明请参阅使用指南。

📄 许可证

Apache-2.0 © Vishal Gupta