📌Overview

Purpose: The primary goal of the Whimsical MCP Server is to facilitate the programmatic creation of Whimsical diagrams through integration with Whimsical's API and Mermaid markup.

Overview: The Whimsical MCP Server is designed to support developers in generating dynamic diagrams efficiently. By leveraging the Model Context Protocol (MCP), it allows for seamless interaction with Whimsical's system to create diagrams from textual representations.

Key Features:

• Diagram Generation: Enables creation of Whimsical diagrams using Mermaid markup, which can be generated by various MCP Clients like Claude and Windsurf, making it versatile for different user needs.

• Output Options: Provides both the URL of the generated Whimsical diagram and a base64 encoded image, allowing clients to easily iterate and refine designs based on the initial markup.

---

Whimsical MCP Server

A Model Context Protocol (MCP) server that enables the creation of Whimsical diagrams programmatically. This server integrates with Whimsical's API to generate diagrams from Mermaid markup.

Demo

Here's an example of a complex system architecture diagram created using this MCP server and Claude - it shows the Model Context Protocol (MCP) architecture itself.

Features

• Create Whimsical diagrams using Mermaid markup generated by the MCP Client (Claude, Windsurf, etc.)
• Returns both the Whimsical diagram URL and a base64 encoded image to allow the Client to iterate on its original markup

Installation

Installing via Smithery

To install Whimsical MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install BrockReece/whimsical-mcp-server --client claude

Manual Installation

# Clone the repository
git clone https://github.com/BrockReece/whimsical-mcp-server.git

# Install dependencies
yarn install

# Build the project
yarn build

Integration with MCP Client

Update the MCP Client's config to point to this repository's dist folder, for example:

{
    "mcpServers": {
        "whimsical": {
            "command": "node",
            "args": [
                "/path/to/this/repo/whimsical-mcp-server/dist/index.js"
            ]
        }
    }
}

License

This project is licensed under the MIT License.