convez.ai
MCP ServerAutomaçãoIntermediário
Adityaaery20

Media MCP Server

Adityaaery20/media-mcp

Processe imagens e vídeos com IA — sem APIs, sem config, sem chaves

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para processamento de imagens e vídeos sem dependências externas ou configuração complexa. Oferece ferramentas de redimensionamento, conversão, compressão, recorte, filtros e análise de mídia. Funciona nativamente com Claude, Cursor, VS Code e qualquer cliente MCP compatível.

Instalação

$npx convez-ai Adityaaery20/media-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 8 meses
Versão
v0.1.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Automação de batch processing de mídia via prompts de IA
  • Otimização e conversão de imagens em pipelines de desenvolvimento
  • Extração de metadados e análise de propriedades de mídia
  • Geração de thumbnails e redimensionamento responsivo
  • Processamento de vídeos (extração de frames, conversão de codecs)

Veredito

MCP server bem arquitetado para quem precisa de processamento de mídia via Claude. Zero overhead de autenticação, suporta imagem e vídeo, mas exige ffmpeg para video. Prático para pipelines de desenvolvimento e automação local.

README

A tradução para o português deste README ainda está na fila.

🎨 media-mcp-server

MCP server for image & video processing. No API keys. No config. Just tools.

Give your AI assistant the power to resize, convert, compress, crop, filter, and analyze images and videos — all through Model Context Protocol.

Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client.


⚡ Quick Start

Claude Code

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

Claude Desktop / Cursor / VS Code

Add to your MCP config:

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

That's it. No API keys, no accounts, no environment variables.


🛠️ Tools

Image Tools

ToolDescription
get_image_infoGet dimensions, format, color mode, file size, EXIF data
resize_imageResize by dimensions or scale factor with aspect ratio control
convert_imageConvert between PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF
compress_imageOptimize file size with quality and max dimension controls
crop_imageCrop to specific pixel coordinates
create_thumbnailGenerate thumbnails with size control
strip_metadataRemove all EXIF/metadata for privacy
rotate_imageRotate by any angle with optional expansion
flip_imageMirror horizontally or vertically
apply_filterApply blur, sharpen, grayscale, emboss, contour, and more

Video Tools (requires ffmpeg)

ToolDescription
get_video_infoGet duration, resolution, codec, bitrate, FPS, audio info
extract_framesPull frames at regular intervals
convert_videoConvert between MP4, WebM, MOV, AVI, GIF, MKV

💬 Example Usage

Once connected, just ask your AI:

"Resize screenshot.png to 800px wide"

"Convert all the PNGs in this folder to WebP"

"Strip the EXIF data from photo.jpg for privacy"

"Compress this image to under 500KB"

"Extract a frame every 5 seconds from demo.mp4"

"What are the dimensions of banner.png?"

"Make a grayscale version of logo.png"

"Create a 128x128 thumbnail of product-photo.jpg"


📦 Installation

Using uvx (recommended — zero install)

uvx media-mcp-server

Using pip

pip install media-mcp-server

With video support

pip install media-mcp-server[video]

Note: Video tools require ffmpeg to be installed on your system. Install it from ffmpeg.org or via your package manager:

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows (with Chocolatey)
choco install ffmpeg

🔧 Configuration

Config file locations

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "media-mcp": {
      "command": "uvx",
      "args": ["media-mcp-server"]
    }
  }
}

Settings → MCP Servers → Add:

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

Add to .vscode/mcp.json:

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

🧪 Development

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

Test with MCP Inspector

npx @modelcontextprotocol/inspector uvx media-mcp-server

📋 Supported Formats

Images: PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF

Videos: MP4, WebM, MOV, AVI, GIF, MKV (requires ffmpeg)


🗺️ Roadmap

  • Batch operations (process entire directories)
  • Image watermarking
  • PDF to image conversion
  • OCR (text extraction from images)
  • Audio extraction from video
  • Image collage/montage creation
  • Smart crop (content-aware)
  • SVG rasterization

📄 License

MIT — do whatever you want with it.


🤝 Contributing

Contributions welcome! Please open an issue first to discuss what you'd like to add.


Built with FastMCP and Pillow

Ver o original no GitHub

Bom para

Relacionados