media-mcp

media-mcp（media-mcp-server）是一个面向 AI 助手的 MCP 服务器，专注于本地图像与视频处理。它通过 Model Context Protocol 将媒体处理工具接入 AI 客户端，让用户可以用自然语言指令完成常见的图像与视频操作。

用途方面，该项目用于为 AI 助手赋予处理图像和视频文件的能力，覆盖缩放、格式转换、压缩、裁剪、滤镜、元数据提取、旋转、翻转、生成缩略图，以及基于 ffmpeg 的视频操作。所有处理均在本地完成，无需 API 密钥、账号或环境变量配置。

主要能力包括：图像处理工具，支持缩放、转换、压缩、裁剪、滤镜、元数据提取、旋转、翻转、缩略图生成；视频处理工具（需要系统安装 ffmpeg），支持视频相关操作。支持格式方面，图像包括 PNG、JPEG、WebP、GIF、BMP、TIFF、ICO、AVIF；视频包括 MP4、WebM、MOV、AVI、GIF、MKV（需要 ffmpeg）。

使用方式上，可将该服务器加入 MCP 客户端配置，支持 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 以及任何兼容 MCP 的客户端。官方推荐使用 uvx 方式进行零安装运行，也可配置视频支持。配置位置方面，macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json；VS Code 可添加到 .vscode/mcp.json。项目基于 FastMCP 和 Pillow 构建，并提供 MCP Inspector 用于测试。

典型使用场景包括：要求 AI 将某张图片调整为指定宽度、把文件夹中的 PNG 批量转换为 WebP、清除照片 EXIF 数据以保护隐私、将图片压缩到指定大小以下、从视频中按间隔抽帧、查询图片尺寸、生成灰度版本或制作指定尺寸缩略图。

限制与说明：视频工具需要系统已安装 ffmpeg，可从 ffmpeg.org 或通过包管理器安装；项目采用 MIT 许可证；欢迎贡献代码，但建议先提交 issue 讨论。资料中标注为后续功能的项目包括批量操作（处理整个目录）、图像水印、PDF 转图像、OCR（从图像提取文本）、从视频提取音频、图像拼贴/蒙太奇、智能裁剪（内容感知）、SVG 栅格化，具体实现状态暂未提供。项目本身不涉及收费信息、价格或平台限制，相关资料暂未提供。