Whimsical

🚀 Whimsical MCP Server

A Model Context Protocol (MCP) server for creating Whimsical diagrams by generating diagrams from Mermaid markup via Whimsical's API. This server enables the programmatic generation of diagrams.

🚀 Quick Start

This is a Model Context Protocol (MCP) server that creates Whimsical diagrams by generating diagrams from Mermaid markup via Whimsical's API. It allows for the programmatic generation of diagrams.

💻 Usage Examples

Basic Usage

Here is an example of a complex system architecture diagram generated using this MCP server and Claude:

✨ Features

• Create Whimsical diagrams using Mermaid markup generated by MCP clients (Claude, Windsurf, etc.).
• Return the URL of the Whimsical diagram and the base64-encoded image, enabling clients to iterate on their original markup.

📦 Installation

Installation via Smithery

To automatically install the Whimsical MCP Server for the Claude desktop 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 Clients

Update the configuration of your MCP client to point to the dist folder of this repository. 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.