Brockreece Whimsical MCP Server

🚀 Whimsical MCP Server

A Model Context Protocol (MCP) server for programmatically creating Whimsical diagrams. This server integrates with Whimsical's API and uses Mermaid markup to generate diagrams.

🚀 Quick Start

A Model Context Protocol (MCP) server designed to programmatically create Whimsical diagrams. It integrates with Whimsical's API and leverages Mermaid markup to generate diagrams.

🔍 Demo

Here is an example of a complex system architecture diagram created using this MCP server and Claude, showcasing the MCP architecture itself:

✨ Features

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

📦 Installation

Install via Smithery

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