Guía de Integración MCP de PicEte

Usa las herramientas de procesamiento de imágenes de PicEte desde Claude Code, Cursor, Claude Desktop o cualquier cliente de IA compatible con MCP.

¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto que permite a los agentes de IA (como Claude Code, Cursor) llamar herramientas externas directamente. Con picete-mcp, tu IA puede procesar imágenes — comprimir, convertir, redimensionar, extraer colores — sin salir de tu terminal y sin subir nada a ningún servidor.

Todo el procesamiento se ejecuta localmente mediante Sharp. Cero datos salen de tu máquina. La misma garantía de privacidad que PicEte.

Inicio Rápido

Instala y ejecuta con un solo comando (sin registro, no requiere configuración para probar):

npx -y picete-mcp

npm Paquete: picete-mcp@1.0.0

Configuración por Plataforma

Añade lo siguiente a la configuración MCP de tu cliente de IA:

Claude Desktop

Edita claude_desktop_config.json:

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

Cursor

Edita .cursor/mcp.json en la raíz de tu proyecto:

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

Claude Code

Edita ~/.claude/settings.json:

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

Herramientas Disponibles

picete-mcp proporciona 13 herramientas en dos categorías:

Herramientas Atómicas

Herramienta	Función	Parámetros Clave
convert	Conversión de formato	source, format (jpeg/png/webp/gif), quality
resize	Redimensionar imagen	source, width, height, fit, keep_aspect_ratio
compress	Comprimir tamaño de archivo	source, quality, target_format, max_size_bytes
extract-colors	Extraer colores dominantes	source, color_count (por defecto 5)
image-to-base64	Convertir a base64/data URL	source, format, data_url
split-image	Dividir en mosaico de cuadrícula	source, rows, cols, overlap_px
metadata	Obtener metadatos de imagen	source
batch	Encadenar múltiples operaciones	sources[], operations[]

Herramientas Inteligentes

Herramienta	Función	Parámetros Clave
optimize-for-web	Optimización web con un clic	source, max_width, quality, output_format
prepare-for-vision-api	Preprocesamiento para IA de Visión + estimación de tokens	source, max_longest_side, quality
favicon	Generar suite de favicon (ico + png)	source, output_dir
compare-images	Comparar dos imágenes (MSE/SSIM/diff)	source1, source2, metric
collage	Unir imágenes	sources[], direction, gap
instagram-split	Dividir en carrusel de Instagram	source, tiles, ratio
social-media-crop	Recortar con zonas seguras	source, platform

Ejemplos de Uso

Pídele a tu IA en lenguaje natural — ella llamará a la herramienta correcta automáticamente:

Tú Dices	Herramienta Usada
"Comprime esta imagen a menos de 200KB"	compress
"Convierte este PNG a WebP"	convert
"Redimensiona esta foto a 1200px de ancho"	resize
"Genera todos los tamaños de favicon desde este logo"	favicon
"¿Qué colores tiene esta imagen?"	extract-colors
"Optimiza esto para mi sitio web"	optimize-for-web
"Prepara esta imagen para GPT-4 Vision"	prepare-for-vision-api
"Divide esta imagen en una cuadrícula de 3x3"	split-image
"Compara estas dos capturas de pantalla"	compare-images
"Obtén los metadatos de esta imagen"	metadata
"Une estas imágenes horizontalmente"	collage
"Convierte esto a base64"	image-to-base64
"Redimensiona y comprime en lote estas 10 imágenes"	batch
"Divide esto para un carrusel de Instagram"	instagram-split
"Recorta esto para mi portada de Facebook"	social-media-crop

Desarrollo

# Clonar y compilar
git clone https://github.com/0000wei/picete-mcp.git
cd picete-mcp
npm install
npm run build

# Iniciar el servidor MCP
npm start

← Volver a PicEte

Desarrollado por PicEte — Herramientas de Imagen Gratuitas en Línea