MCP Image Extractor

MCP Image Extractor

Servidor MCP para extrair e converter imagens para base64 para análise por LLMs.

Este servidor MCP fornece ferramentas para assistentes de IA:

• Extrair imagens de arquivos locais
• Extrair imagens de URLs
• Processar imagens codificadas em base64

Como aparece no Cursor:

Casos de uso adequados:

• analisar resultados de testes do playwright: capturas de tela

Instalação

Recomendado: Usando npx no mcp.json (Mais fácil)

A forma recomendada de instalar este servidor MCP é usando npx diretamente no seu arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "image-extractor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image-extractor"
      ]
    }
  }
}

Esta abordagem:

• Instala automaticamente a versão mais recente
• Não requer instalação global
• Funciona de forma confiável em diferentes ambientes

Alternativa: Instalação por Caminho Local

Se preferir usar uma instalação local do pacote, você pode clonar o repositório e apontar para os arquivos compilados:

{
  "mcpServers": {
    "image-extractor": {
      "command": "node",
      "args": ["/full/path/to/mcp-image-extractor/dist/index.js"],
      "disabled": false
    }
  }
}

Instalação Manual

# Clone and install 
git clone https://github.com/ifmelate/mcp-image-extractor.git
cd mcp-image-extractor
npm install
npm run build
npm link

Isso tornará o comando mcp-image-extractor disponível globalmente.

Em seguida, configure no .cursor/mcp.json:

{
  "mcpServers": {
    "image-extractor": {
      "command": "mcp-image-extractor",
      "disabled": false
    }
  }
}

Solução de problemas para usuários do Cursor: Se você vir o erro "Failed to create client", tente o método de instalação por caminho local acima ou certifique-se de estar usando o caminho correto para o executável.

Ferramentas Disponíveis

extract_image_from_file

Extrai uma imagem de um arquivo local e a converte para base64.

Parâmetros:

• file_path (obrigatório): Caminho para o arquivo de imagem local

Nota: Todas as imagens são redimensionadas automaticamente para dimensões ideais (máx. 512x512) para análise por LLMs, a fim de limitar o tamanho da saída base64 e otimizar o uso da janela de contexto.

extract_image_from_url

Extrai uma imagem de uma URL e a converte para base64.

Parâmetros:

• url (obrigatório): URL da imagem a ser extraída

Nota: Todas as imagens são redimensionadas automaticamente para dimensões ideais (máx. 512x512) para análise por LLMs, a fim de limitar o tamanho da saída base64 e otimizar o uso da janela de contexto.

extract_image_from_base64

Processa uma imagem codificada em base64 para análise por LLMs.

Parâmetros:

• base64 (obrigatório): Dados da imagem codificados em base64
• mime_type (opcional, padrão: "image/png"): Tipo MIME da imagem

Nota: Todas as imagens são redimensionadas automaticamente para dimensões ideais (máx. 512x512) para análise por LLMs, a fim de limitar o tamanho da saída base64 e otimizar o uso da janela de contexto.

Exemplo de Uso

Aqui está um exemplo de como usar as ferramentas a partir do Claude:

Please extract the image from this local file: images/photo.jpg

O Claude usará automaticamente a ferramenta extract_image_from_file para carregar e analisar o conteúdo da imagem.

Please extract the image from this URL: https://example.com/image.jpg

O Claude usará automaticamente a ferramenta extract_image_from_url para buscar e analisar o conteúdo da imagem.

Docker

Compile e execute com Docker:

docker build -t mcp-image-extractor .
docker run -p 8000:8000 mcp-image-extractor

Licença

MIT