@auraimage/mcp-server

Model Context Protocol server that gives any MCP-compatible AI agent (Claude Code, Cursor, Cline, Continue, etc.) direct access to the AuraImage toolkit — auditing, migrating, and generating responsive image markup without leaving the editor.

Tools exposed

| Tool | Description | |------|-------------| | audit_lcp | Scans a project directory for unoptimized images and estimates LCP savings. | | migrate_assets | Uploads local images to AuraImage and returns the new CDN URLs. Supports dryRun: true. | | generate_alt | Generates accessible alt text for an image URL using vision AI. | | generate_responsive_tag | Returns a <picture> element with AVIF + WebP srcsets for the given image. | | smart_crop_preview | Returns crop variant URLs for an image at the requested width/height. |

Configuration

Add the server to your project's .mcp.json:

{
  "mcpServers": {
    "auraimage": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@auraimage/mcp-server@latest"],
      "env": {
        "AURA_SECRET_KEY": "${AURA_SECRET_KEY}"
      }
    }
  }
}

Environment variables

| Variable | Needed by | Notes | |----------|-----------|-------| | AURA_SECRET_KEY | migrate_assets | Your project's Secret Key — signs upload tokens. Keep it server-side. |

audit_lcp, generate_alt, generate_responsive_tag, and smart_crop_preview need no credentials. generate_alt is generated server-side by the AuraImage API (GPT-5.6 Luna) for images already on the AuraImage CDN, rate-limited per IP. The server always starts without any environment variables; a tool that is missing its key returns a clear error when called.

Run standalone

npx @auraimage/mcp-server@latest

The server speaks stdio and is compatible with every MCP-aware client.

Documentation

Full docs and tool examples: auraimage.ai/docs/ai-integration.

License

MIT © AuraImage