Tinypng MCP Server

🚀 TinyPNG MCP Server

A server for compressing images using the TinyPNG API, which can be integrated with Smithery and used in various scenarios.

🚀 Quick Start

Run the Server with bun or node

1. Install dependencies and build the project.

pnpm i
pnpm build

2. Modify the mcp.json file.

{
  "mcpServers": {
    "tinypng": {
      "command": "bun", // or "node"
      "args": ["/path/to/tinypng-mcp-server/src/index.ts"], // or "dist/index.js"
      "env": {
        "TINYPNG_API_KEY": "your-tinypng-api-key"
      }
    }
  }
}

Install via Smithery

Automatically install the TinyPNG MCP Server for Claude Desktop through Smithery:

npx -y @smithery/cli install @aiyogg/tinypng-mcp-server --client claude

💻 Usage Examples

Tools

Compress Local Images

{
  name: 'compress_local_image',
  description: 'Compress a local image file',
  inputSchema: {
    type: 'object',
    properties: {
      imagePath: {
        type: 'string',
        description: 'The absolute path of the image file to be compressed',
        example: '/Users/user/Downloads/image.jpg',
      },
      outputPath: {
        type: 'string',
        description: 'The absolute path to save the compressed image file',
        example: '/Users/user/Downloads/image_compressed.jpg',
      },
      outputFormat: {
        type: 'string',
        description: 'The format to save the compressed image file',
        enum: SUPPORTED_IMAGE_TYPES,
        example: 'image/jpeg',
      },
    },
    required: ['imagePath'],
  },
}

Compress Remote Images

{
  name: 'compress_remote_image',
  description: 'Compress a remote image file by providing its URL',
  inputSchema: {
    type: 'object',
    properties: {
      imageUrl: {
        type: 'string',
        description: 'The URL of the image file to be compressed',
        example: 'https://example.com/image.jpg',
      },
      outputPath: {
        type: 'string',
        description: 'The absolute path to save the compressed image file',
        example: '/Users/user/Downloads/image_compressed.jpg',
      },
      outputFormat: {
        type: 'string',
        description: 'The format to save the compressed image file',
        enum: SUPPORTED_IMAGE_TYPES,
        example: 'image/jpeg',
      },
    },
    required: ['imageUrl'],
  },
}