viucraft-mcp

VIUCraft MCP server — use VIUCraft image operations as AI tools via the Model Context Protocol.

This package is a proxy: it forwards tool calls to the VIUCraft HTTP API. No image processing happens locally.

Quick Start (Claude Desktop)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "viucraft": {
            "command": "npx",
            "args": ["viucraft-mcp"],
            "env": {
                "VIUCRAFT_API_KEY": "vc_live_..."
            }
        }
    }
}

Environment Variables

| Variable | Required | Default | |----------|----------|---------| | VIUCRAFT_API_KEY | yes | — | | VIUCRAFT_API_URL | no | https://api.viucraft.com |

Available Tools

• resize_image — resize to width/height with optional fit mode
• crop_image — crop with optional gravity or offset
• convert_format — convert to jpg/png/webp/avif/gif with optional quality
• apply_filter — apply blur/grayscale/sepia/sharpen/invert/vignette/pixelate
• transform_image — arbitrary operation pipeline or named preset

See the full MCP reference for complete tool documentation.

Build

npm install
npm run build