BlockWerk MCP Server

BlockWerk MCP Server bridges external AI clients (like Claude Desktop or Cursor) to a live BlockWerk browser tab. This allows an AI to observe and manipulate your block diagrams in real-time.

🚀 Features

• Read Canvas: The AI can see all blocks, connections, and parameters.
• Manipulate Canvas: Add blocks, connect ports, update parameters, and delete blocks.
• Simulation Control: Run simulations, perform frequency sweeps (Bode plots), and analyze system topology.
• Layout Engine: Automatic layout tidying.

📦 Installation

You can run it directly via npx:

npx blockwerk-mcp --session <YOUR_SESSION_ID>

Or install it globally:

npm install -g blockwerk-mcp

🛠️ Setup

1. Get your Session ID

1. Open blockwerk.tech.
2. Click on the AI Assistant panel (right side).
3. Select Connect External AI.
4. Copy the provided Session ID (e.g., bw-a1b2c3d4).

2. Configure your Client

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "blockwerk": {
      "command": "npx",
      "args": ["-y", "blockwerk-mcp", "--session", "YOUR_SESSION_ID"]
    }
  }
}

Cursor

1. Go to Settings > Models > MCP.
2. Add a new MCP server:
   • Name: BlockWerk
   • Type: command
   • Command: npx -y blockwerk-mcp --session YOUR_SESSION_ID

👨‍💻 Development

If you want to contribute or run from source:

git clone https://github.com/blockwerk/blockwerk
cd ui/blockwerk/projects/mcp-server
npm install
npm run build
npm run dev -- --session <YOUR_SESSION_ID>

📄 License

MIT