Openflowkit MCP logo

Openflowkit MCP

Local-first MCP tools for creating, validating, inspecting, and exporting OpenFlowKit diagrams and architecture models.

Install Openflowkit MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "openflowkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "openflowkit"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

openflowkit-mcp exposes OpenFlowKit’s local diagramming canvas and DSL operations to Claude, Cursor, Windsurf, and other MCP clients. Agents can generate or update diagrams, inspect canvas state, export files, search icons, and validate OpenFlow DSL alongside Mermaid, Structurizr DSL, and D2 conversions. Repository analysis tools scan local files offline to propose architecture models, compare diagrams with code, and provide evidence for detected components. Reach for it when an agent needs to create architecture or other diagrams while keeping source text, canvas edits, and local repository analysis in one workflow.

Use cases

  • Generate architecture diagrams from local repositories
  • Validate and convert diagram source text
  • Inspect and reconcile diagrams with code
  • Edit diagram frames through an MCP client
  • Export diagrams for documentation and review

Key features

  • OpenFlow DSL validation and conversion
  • Offline repository architecture analysis
  • Text and canvas diagram editing
  • Icon and syntax discovery
  • Document and image export
  • Architecture drift reporting

Tools29

What Openflowkit MCP lets your agent do. Expand a tool for its parameters.

Verified live~6.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

25/26 checks healthy over the last 92d

What it can do

From the 29 tools this server returned when we ran it.

Can delete or modify data · 2Makes network requests · 1Read-only tools · 27
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age134 days
Maintainers1

Observed 2026-10-18 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · openflowkit (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars962Stargazers on the source repository.
npm downloads1.1kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed29Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Openflowkit MCP works

What openflowkit-mcp does

openflowkit-mcp connects an MCP client to OpenFlowKit’s diagram editor and document model. It supports both text-driven diagrams and direct canvas operations, allowing an agent to create frames from OpenFlow DSL, redraw existing frames, move or style nodes, add shapes, and inspect pages or selections.

The server also covers architecture discovery and review. Local repository scans identify services, platforms, languages, directories, infrastructure files, datastore usage, and HTTP clients. These findings can seed a proposed C4 workspace, be compared against an existing model, or be attached to an individual element with repository evidence and linked ADR markdown files.

How it works

OpenFlow DSL is the primary text format. Mermaid, Structurizr DSL, and D2 can be passed through validation and conversion before being rendered. Validation returns structured diagnostics with severity, location, messages, and hints; converted input also reports the resulting DSL and lines that could not be preserved.

Documents can be created in memory or loaded from disk, then saved back to files. Diagram frames retain a relationship between authored DSL and canvas state. get_diagram reports edits such as moved, renamed, recoloured, resized, or rewired elements, while update_diagram redraws from replacement text and identifies canvas changes that would be discarded.

Repository analysis is deterministic and offline. It reads the supplied directory rather than using network access, making analyze_codebase, discover_architecture, and drift_report suitable for local checkouts and repeatable review workflows.

Setup and configuration

Use openflowkit-mcp as an MCP server from a compatible client such as Claude Code, Cursor, or Windsurf. A paired live editor is needed for canvas-dependent operations such as screenshots, camera changes, and selection-aware inspection; file-mode operations can work with documents held by the server or loaded from disk.

The server exposes local document state within its process. whoami reports whether an editor is paired and which documents are available, while server_info lists the server’s version, tools, resources, and prompts for connection troubleshooting.

Tools and capabilities

  • Validate OpenFlow, Mermaid, Structurizr DSL, and D2 input with line-level diagnostics.
  • Inspect syntax, node types, shapes, arrows, wireframe controls, screen frames, and shipped icon packs.
  • Create, open, save, list, inspect, and export documents and diagram frames.
  • Draw, redraw, move, style, delete, and add canvas elements with undo-step operations.
  • Export SVG, PNG, PDF, JSON, and animation formats, including animated SVG, GIF, MP4, and WebM where the required editor capabilities are available.
  • Scan repositories, propose architecture workspaces, report model drift, and explain elements with evidence.

Limitations and notes

Repository analysis does not access the network. Live-editor tools require the editor to be paired, and raster animation export depends on WebCodecs. Regenerating a diagram from text can drop canvas-only changes unless the replacement DSL carries them; get_diagram exposes those edits and any losses before an update. Screenshots are also tied to a live editor connection.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Openflowkit MCP

openflowkit-mcp is an MCP server that connects AI clients to OpenFlowKit’s local diagram editor and document model. Its main tools validate and convert diagram DSL, create and update diagrams, inspect canvas state, export files, search icons, and analyze local repositories for architecture evidence.

Configure openflowkit-mcp as an MCP server in a compatible client such as Claude Code, Cursor, or Windsurf.

Yes, openflowkit-mcp works with Cursor. The server is described for Cursor, Claude, Windsurf, and other MCP clients; canvas-dependent operations require a paired live OpenFlowKit editor.

Yes, openflowkit-mcp analyzes local directories without network access. analyze_codebase detects platforms, services, structure, and languages, while discover_architecture proposes a C4 workspace and drift_report compares repository evidence with an architecture model.

openflowkit-mcp reports canvas changes through get_diagram, including moves, renames, styling, resizing, icon changes, and connector edits. When text is used to redraw a frame, update_diagram identifies edits that the replacement DSL does not carry and would therefore discard.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOpenflowkit MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/openflowkit-mcp?style=directory)](https://allmcps.com/mcp/openflowkit-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/openflowkit-mcp"><img src="https://allmcps.com/api/badge/openflowkit-mcp?style=directory" alt="Openflowkit MCP on AllMCPs" /></a>