Herramientas de imagen MCP

👁 insignia de herrería

Un servicio de Protocolo de Contexto de Modelo (MCP) para recuperar dimensiones de imágenes y comprimir imágenes, compatible con fuentes de archivos locales y URL.

中文文档

Características

• Recuperar dimensiones de imágenes a partir de URL

• Obtener las dimensiones de la imagen desde archivos locales

• Comprimir imágenes desde URL usando la API TinyPNG

• Comprimir imágenes locales usando la API TinyPNG

• Convertir imágenes a diferentes formatos (webp, jpeg/jpg, png)

• Devuelve información de ancho, alto, tipo, tipo MIME y compresión.

Resultados de ejemplo

👁 Ejemplo Resultado 1
👁 Ejemplo Resultado 2

Descargar desde la URL de Figma y comprimir👁 Ejemplo Resultado 3

Related MCP server: File Converter MCP Server

Uso

Utilizando como servicio MCP

Este servicio proporciona cinco funciones de herramienta:

1. get_image_size - Obtener las dimensiones de las imágenes remotas

2. get_local_image_size - Obtener las dimensiones de las imágenes locales

3. compress_image_from_url - Comprime imágenes remotas usando la API TinyPNG

4. compress_local_image : comprime imágenes locales usando la API TinyPNG

5. figma : obtiene enlaces de imágenes de la API de Figma y los comprime usando la API TinyPNG

Integración de clientes

Para usar este servicio MCP, debe conectarse desde un cliente MCP. A continuación, se muestran ejemplos de integración con diferentes clientes:

Uso con Claude Desktop

1. Instalar Claude Desktop desde claude.ai/download

2. Obtenga la clave API de TinyPNG: Visite TinyPNG y obtenga su clave API

3. Configure Claude Desktop para utilizar este servidor MCP editando el archivo de configuración:

{
 "mcpServers": {
 "image-tools": {
 "command": "npx",
 "args": ["image-tools-mcp"],
 "env": {
 "TINIFY_API_KEY": "<YOUR_TINIFY_API_KEY>",
 "FIGMA_API_TOKEN": "<YOUR_FIGMA_API_TOKEN>"
 }
 }
 }
}

3. Reiniciar Claude Desktop

4. Pídele a Claude que obtenga las dimensiones de la imagen: "¿Puedes decirme las dimensiones de esta imagen: https://example.com/image.jpg ?"

5. Pídele a Claude que comprima una imagen: "¿Puedes comprimir esta imagen: https://example.com/image.jpg ? "

6. Pídele a Claude que comprima una imagen local: "¿Puedes comprimir esta imagen: D:/path/to/image.png?"

7. Pídele a Claude que comprima una carpeta de imágenes local: "¿Puedes comprimir esta carpeta: D:/imageFolder?"

8. Pídele a Claude que obtenga enlaces de imágenes de la API de Figma: "¿Puedes obtener enlaces de imágenes de la API de Figma: https://www.figma.com/file/XXXXXXX ?"

Uso con la biblioteca de cliente MCP

import { McpClient } from "@modelcontextprotocol/client";

// Initialize the client
const client = new McpClient({
 transport: "stdio" // or other transport options
});

// Connect to the server
await client.connect();

// Get image dimensions from URL
const urlResult = await client.callTool("get_image_size", {
 options: {
 imageUrl: "https://example.com/image.jpg"
 }
});
console.log(JSON.parse(urlResult.content[0].text));
// Output: { width: 800, height: 600, type: "jpg", mime: "image/jpeg" }

// Get image dimensions from local file
const localResult = await client.callTool("get_local_image_size", {
 options: {
 imagePath: "D:/path/to/image.png"
 }
});
console.log(JSON.parse(localResult.content[0].text));
// Output: { width: 1024, height: 768, type: "png", mime: "image/png", path: "D:/path/to/image.png" }

// Compress image from URL
const compressUrlResult = await client.callTool("compress_image_from_url", {
 options: {
 imageUrl: "https://example.com/image.jpg",
 outputFormat: "webp" // Optional: convert to webp, jpeg/jpg, or png
 }
});
console.log(JSON.parse(compressUrlResult.content[0].text));
// Output: { originalSize: 102400, compressedSize: 51200, compressionRatio: "50.00%", tempFilePath: "/tmp/compressed_1615456789.webp", format: "webp" }

// Compress local image
const compressLocalResult = await client.callTool("compress_local_image", {
 options: {
 imagePath: "D:/path/to/image.png",
 outputPath: "D:/path/to/compressed.webp", // Optional
 outputFormat: "image/webp" // Optional: convert to image/webp, image/jpeg, or image/png
 }
});
console.log(JSON.parse(compressLocalResult.content[0].text));
// Output: { originalSize: 102400, compressedSize: 51200, compressionRatio: "50.00%", outputPath: "D:/path/to/compressed.webp", format: "webp" }

// Fetch image links from Figma API

const figmaResult = await client.callTool("figma", {
 options: {
 figmaUrl: "https://www.figma.com/file/XXXXXXX"
 }
});
console.log(JSON.parse(figmaResult.content[0].text));
// Output: { imageLinks: ["https://example.com/image1.jpg", "https://example.com/image2.jpg"] }

### Tool Schemas

#### get_image_size

```typescript
{
 options: {
 imageUrl: string // URL of the image to retrieve dimensions for
 }
}

obtener_tamaño_de_imagen_local

{
 options: {
 imagePath: string; // Absolute path to the local image file
 }
}

comprimir_imagen_desde_url

{
 options: {
 imageUrl: string // URL of the image to compress
 outputFormat?: "image/webp" | "image/jpeg" | "image/jpg" | "image/png" // Optional output format
 }
}

comprimir_imagen_local

{
 options: {
 imagePath: string // Absolute path to the local image file
 outputPath?: string // Optional absolute path for the compressed output image
 outputFormat?: "image/webp" | "image/jpeg" | "image/jpg" | "image/png" // Optional output format
 }
}

Figma

{
 options: {
 figmaUrl: string; // URL of the Figma file to fetch image links from
 }
}

Registro de cambios

• 12/05/2025: Se actualizó la API de Figma para admitir parámetros adicionales, incluido un escalado de imagen de 2x.

Implementación técnica

Este proyecto se basa en las siguientes bibliotecas:

• probe-image-size : para la detección de la dimensión de la imagen

• tinify - Para la compresión de imágenes a través de la API TinyPNG

• figma-api : para obtener enlaces de imágenes de la API de Figma

Variables de entorno

• TINIFY_API_KEY : Necesaria para la compresión de imágenes. Obtén tu clave API de TinyPNG.

  • Cuando no se proporcionan, las herramientas de compresión ( compress_image_from_url y compress_local_image ) no se registrarán

• FIGMA_API_TOKEN : Necesario para obtener enlaces de imágenes de la API de Figma. Obtén tu token de API de Figma.

  • Cuando no se proporciona, la herramienta Figma ( figma ) no se registrará

Nota: Las herramientas básicas de dimensión de imagen ( get_image_size y get_local_image_size ) siempre están disponibles independientemente de las claves API.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• get_image_sizeC
• get_local_image_sizeC