AI导哈

媒体处理服务器

一个无需API密钥和配置的媒体处理服务器，提供图像和视频的调整大小、转换、压缩、裁剪、过滤和分析功能。

  • by Adityaaery20
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 Adityaaery20/media-mcp

使用说明

🎨 媒体mcp服务器

用于图像和视频处理的MCP服务器。没有API密钥。没有配置。只是工具。

赋予你的AI助手调整大小、转换、压缩、裁剪、过滤和分析图像和视频的能力——全程 模型上下文协议.

适用于 克劳德桌面版, 克劳德代码, 光标, VS Code, 帆板运动，以及任何兼容MCP的客户端。

⚡ 快速开始

克劳德代码

claude mcp add media-mcp -- uvx media-mcp-server

克劳德桌面/光标/VS代码

添加到MCP配置中：

{
  "mcpServers": {
    "media-mcp": {
      "command": "uvx",
      "args": ["media-mcp-server"]
    }
  }
}

就是这样，没有API键，没有帐户，没有环境变量。

🛠️ 工具

图像工具

工具 说明
get_image_info 获取尺寸、格式、颜色模式、文件大小、EXIF数据
resize_image 通过纵横比控制按尺寸或比例因子调整大小
convert_image 在PNG、JPEG、WebP、GIF、BMP、TIFF、ICO、AVIF之间转换
compress_image 通过质量和最大尺寸控制优化文件大小
crop_image 裁剪到特定像素坐标
create_thumbnail 生成具有大小控制的缩略图
strip_metadata 删除所有EXIF/元数据以保护隐私
rotate_image 旋转任意角度，可选择膨胀
flip_image 水平或垂直镜像
apply_filter 应用模糊、锐化、灰度、浮雕、轮廓等

视频工具（必需 FFmpeg)

工具 说明
get_video_info 获取持续时间、分辨率、编解码器、比特率、FPS、音频信息
extract_frames 定期拉动框架
convert_video 在MP4、WebM、MOV、AVI、GIF、MKV之间转换

💬 示例用法

连接后，只需询问您的AI：

“将屏幕截图.png调整为800px宽”

“将此文件夹中的所有PNG转换为WebP”

“为了保护隐私，从photo.jpg中删除EXIF数据”

“将此图像压缩到500KB以下”

“从demo.mp4中每5秒提取一帧”

“banner.png的尺寸是多少？”

“制作logo.png的灰度版本”

“创建产品照片的128x128缩略图.jpg”

📦 安装

使用uvx（推荐——零安装）

uvx media-mcp-server

使用pip

pip install media-mcp-server

支持视频

pip install media-mcp-server[video]

注： 视频工具需要 ffmpeg 安装在您的系统上。 从安装 ffmpeg.org 或通过您的包裹管理器：

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows (with Chocolatey)
choco install ffmpeg

🔧 配置

配置文件位置

Claude Desktop
  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "media-mcp": {
      "command": "uvx",
      "args": ["media-mcp-server"]
    }
  }
}
Claude Code ```bash claude mcp add media-mcp -- uvx media-mcp-server ```
Cursor

设置→ MCP服务器→ Add:

{
  "media-mcp": {
    "command": "uvx",
    "args": ["media-mcp-server"]
  }
}
VS Code

添加 .vscode/mcp.json:

{
  "servers": {
    "media-mcp": {
      "command": "uvx",
      "args": ["media-mcp-server"]
    }
  }
}

🧪 发展

git clone https://github.com/Adityaaery20/media-mcp.git
cd media-mcp
pip install -e ".[dev]"
pytest

使用MCP检查员进行测试

npx @modelcontextprotocol/inspector uvx media-mcp-server

📋 支持格式

图像： PNG、JPEG、WebP、GIF、BMP、TIFF、ICO、AVIF

视频： MP4、WebM、MOV、AVI、GIF、MKV （需要ffmpeg）

🗺️ 路线图

  • []批处理操作（处理整个目录）
  • []图像水印
  • []PDF到图像转换
  • []OCR（从图像中提取文本）
  • []从视频中提取音频
  • []图像拼贴/蒙太奇创作
  • []智能裁剪（内容感知）
  • []SVG光栅化

📄 许可证

麻省理工学院——随心所欲。

🤝 贡献

欢迎投稿！请先打开一个问题，讨论您想添加什么。

建于 FastMCP 和 枕头

相关 MCP