Satori MCP Server lets you generate beautiful images from React components using the Satori renderer. It exposes MCP endpoints that accept JSX-like content or pre-built templates and returns references to generated images stored in Vercel Blob Storage. The built-in tools include generate_image for creating images from custom JSX, and generate_from_template for applying predefined templates (social cards, blog headers, and quotes) with parameters such as title, description, and background color. You can also list available templates with list_templates. This makes it easy to produce social-ready images for blog posts, quotes, or hero headers directly from an AI assistant or automation workflow.

Prerequisites:

• Node.js 20+
• pnpm (recommended) or npm

Installation steps:

1. Clone the repository git clone https://github.com/Jellypod-Inc/satori-mcp-server.git
2. Navigate into the project cd satori-mcp-server
3. Install dependencies pnpm install

   or npm install

4. Run the development server pnpm dev

   or npm run dev

Notes:

• The server stores generated images to Vercel Blob Storage; ensure you provide a valid BLOB_READ_WRITE_TOKEN in the environment.
• For production, build and then start the production server: pnpm build pnpm start

Environment variables and configuration tips:

• BLOB_READ_WRITE_TOKEN: Required for saving and accessing generated images on Vercel Blob Storage. Obtain from the Vercel dashboard and set it in your environment.
• The server is intended to be run behind MCP clients (e.g., Claude Desktop) or via MCP tooling; ensure your MCP client is configured to point to the server URL when using hosted mode.
• Templates support googleFonts for font loading; you can specify fonts in the template params or image generation calls to ensure consistent typography. Common issues:
• If images fail to generate, verify that the blob storage token is valid and that the network can reach the Vercel Blob Storage endpoint.
• Ensure Node.js version matches the project requirements (Node 20+).
• For large images, MCP responses may include a storage URL rather than a base64 image; handle the URL returned by the MCP client accordingly.