Инструменты изображения MCP

значок кузнеца

Служба протокола контекста модели (MCP) для получения размеров изображений и сжатия изображений, поддерживающая как URL-адреса, так и локальные источники файлов.

中文文档

Функции

Извлечение размеров изображения из URL-адресов
Получить размеры изображения из локальных файлов
Сжатие изображений из URL-адресов с помощью API TinyPNG
Сжатие локальных изображений с помощью API TinyPNG
Конвертируйте изображения в различные форматы (webp, jpeg/jpg, png)
Возвращает ширину, высоту, тип, тип MIME и информацию о сжатии.

Примеры результатов

Пример результата 1 Пример результата 2

скачать с figma url и сжать Пример результата 3

Related MCP server: File Converter MCP Server

Использование

Использование в качестве MCP-сервиса

Этот сервис предоставляет пять функций инструмента:

get_image_size — Получить размеры удаленных изображений
get_local_image_size — Получить размеры локальных изображений
compress_image_from_url — сжатие удаленных изображений с помощью API TinyPNG
compress_local_image — сжатие локальных изображений с помощью API TinyPNG
figma — извлекайте ссылки на изображения из API Figma и сжимайте их с помощью API TinyPNG

Интеграция клиента

Чтобы использовать эту службу MCP, вам необходимо подключиться к ней с клиента MCP. Вот примеры того, как интегрироваться с разными клиентами:

Использование с Claude Desktop

Установите Claude Desktop с claude.ai/download
Получите ключ API TinyPNG: посетите TinyPNG и получите свой ключ API
Настройте Claude Desktop для использования этого сервера MCP, отредактировав файл конфигурации:

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

Перезагрузить рабочий стол Клода
Попросите Клода узнать размеры изображения: «Можете ли вы сказать мне размеры этого изображения: https://example.com/image.jpg »
Попросите Клода сжать изображение: «Можете ли вы сжать это изображение: https://example.com/image.jpg »
Попросите Клода сжать локальное изображение: «Можете ли вы сжать это изображение: D:/path/to/image.png»
Попросите Клода сжать локальную папку с изображениями: «Можете ли вы сжать эту папку: D:/imageFolder»
Попросите Клода получить ссылки на изображения из API Figma: «Можете ли вы получить ссылки на изображения из API Figma: https://www.figma.com/file/XXXXXXX »

Использование с клиентской библиотекой 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
  }
}

получить_локальный_размер_изображения

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

сжать_изображение_из_url

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

сжать_локальное_изображение

{
  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
  }
}

фигма

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

Журнал изменений

2025-05-12: Обновлен API Figma для поддержки дополнительных параметров, включая двукратное масштабирование изображения.

Техническая реализация

Этот проект построен на следующих библиотеках:

probe-image-size — для определения размера изображения
tinify — для сжатия изображений с помощью API TinyPNG
figma-api — для получения ссылок на изображения из API Figma

Переменные среды

TINIFY_API_KEY — Требуется для функциональности сжатия изображений. Получите свой ключ API от TinyPNG
- Если не указано иное, инструменты сжатия ( compress_image_from_url и compress_local_image ) не будут зарегистрированы.
FIGMA_API_TOKEN - Требуется для получения ссылок на изображения из Figma API. Получите свой API-токен из Figma
- Если не указано иное, инструмент Figma ( figma ) не будет зарегистрирован.

Примечание: основные инструменты измерения размеров изображения ( get_image_size и get_local_image_size ) всегда доступны независимо от ключей API.

Лицензия

Массачусетский технологический институт

image-tools-mcp