PicEte MCP Guia de Integração

Use as ferramentas de processamento de imagem do PicEte a partir do Claude Code, Cursor, Claude Desktop ou qualquer cliente de IA compatível com MCP.

O que é MCP?

Model Context Protocol (MCP) é um padrão aberto que permite que agentes de IA (como Claude Code, Cursor) chamem ferramentas externas diretamente. Com o picete-mcp, sua IA pode processar imagens — comprimir, converter, redimensionar, extrair cores — sem sair do terminal e sem enviar nada para nenhum servidor.

Todo o processamento é executado localmente via Sharp. Zero dados saem da sua máquina. A mesma garantia de privacidade do PicEte.

Início Rápido

Instale e execute com um único comando (sem cadastro, sem configuração necessária para testes):

npx -y picete-mcp

npm Pacote: picete-mcp@1.0.0

Configuração por Plataforma

Adicione o seguinte à configuração MCP do seu cliente de IA:

Claude Desktop

Edite o claude_desktop_config.json:

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

Cursor

Edite o .cursor/mcp.json na raiz do seu projeto:

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

Claude Code

Edite o ~/.claude/settings.json:

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

Ferramentas Disponíveis

picete-mcp oferece 13 ferramentas em duas categorias:

Ferramentas Atômicas

Ferramenta	Função	Parâmetros Principais
convert	Conversão de formato	source, format (jpeg/png/webp/gif), quality
resize	Redimensionar imagem	source, width, height, fit, keep_aspect_ratio
compress	Comprimir tamanho do arquivo	source, quality, target_format, max_size_bytes
extract-colors	Extrair cores dominantes	source, color_count (padrão 5)
image-to-base64	Converter para base64/data URL	source, format, data_url
split-image	Dividir em grade de tiles	source, rows, cols, overlap_px
metadata	Obter metadados da imagem	source
batch	Encadear múltiplas operações	sources[], operations[]

Ferramentas Inteligentes

Ferramenta	Função	Parâmetros Principais
optimize-for-web	Otimização web com um clique	source, max_width, quality, output_format
prepare-for-vision-api	Pré-processamento para IA de Visão + estimativa de tokens	source, max_longest_side, quality
favicon	Gerar conjunto de favicon (ico + png)	source, output_dir
compare-images	Comparar duas imagens (MSE/SSIM/diff)	source1, source2, metric
collage	Unir imagens	sources[], direction, gap
instagram-split	Dividir em carrossel do Instagram	source, tiles, ratio
social-media-crop	Cortar com zonas seguras	source, platform

Exemplos de Uso

Peça à sua IA em linguagem natural — ela chamará a ferramenta certa automaticamente:

Você Diz	Ferramenta Chamada
"Comprima esta imagem para menos de 200KB"	compress
"Converta este PNG para WebP"	convert
"Redimensione esta foto para 1200px de largura"	resize
"Gere todos os tamanhos de favicon a partir deste logotipo"	favicon
"Quais cores estão nesta imagem?"	extract-colors
"Otimize isto para o meu site"	optimize-for-web
"Prepare esta imagem para GPT-4 Vision"	prepare-for-vision-api
"Divida esta imagem em uma grade 3x3"	split-image
"Compare estas duas capturas de tela"	compare-images
"Obtenha os metadados desta imagem"	metadata
"Una estas imagens horizontalmente"	collage
"Converta isto para base64"	image-to-base64
"Redimensione e comprima em lote estas 10 imagens"	batch
"Divida isso para um carrossel do Instagram"	instagram-split
"Corte isso para minha capa do Facebook"	social-media-crop

Desenvolvimento

# Clone e compile
git clone https://github.com/0000wei/picete-mcp.git
cd picete-mcp
npm install
npm run build

# Inicie o servidor MCP
npm start

← Voltar ao PicEte

Desenvolvido por PicEte — Ferramentas de Imagem Online Gratuitas