Whimsical MCP Server

🚀 Whimsical MCP Server

A Model Context Protocol (MCP) server that allows generating Whimsical diagrams from Mermaid markup. This server integrates with Whimsical's API to generate diagrams from Mermaid markup.

🚀 Quick Start

This is a Model Context Protocol (MCP) server that enables the generation of Whimsical diagrams through Mermaid markup. It integrates with Whimsical's API to create diagrams based on Mermaid markup.

✨ Features

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

💻 Usage Examples

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

📦 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 file of the 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 released under the MIT License.