Best for
- Developers wanting to integrate AI-assisted diagramming into their workflow.
- Teams that prioritize data privacy and prefer local tools.
- Workflows that benefit from tight coupling between code and diagrams.
O
OpenFlowKit MCP Server
Community
Local-first open-source diagramming tools for Claude, Cursor, Windsurf & other MCP clients.
GitHub source repository ↗
67FMRS · C
OpenFlowKit MCP server is a lightweight local extension of the diagramming tool, offering several useful utilities for integrating diagram creation into AI workflows. Installation is straightforward, but functionality is limited to the current version; some advanced features are not yet implemented.
The OpenFlowKit MCP server provides local-first diagramming tools for MCP clients like Claude, Cursor, Windsurf, and others. It offers deterministic validation, codebase analysis, templates, icon lookup, and viewer links without requiring an API key or cloud round-trip. Everything runs locally on the user's machine via a pure Node package distributed through npm.
Tools
validate_dsl
Validates OpenFlowKit DSL syntax to ensure diagram descriptions are correct.
create_viewer_url
Generates a viewer URL to open and edit diagrams in the browser.
analyze_codebase
Analyzes a codebase to extract architecture information and generate diagrams.
find_icon_slug
Searches the icon catalog for matching icon slugs for automatic icon assignment.
fetch_template
Fetches available diagram templates as starting points for creations.
inspect_capabilities
Inspects the MCP server's capabilities, listing available tools and resources.
Setup
Add the following configuration to your MCP client:
{
"mcpServers": {
"openflowkit": {
"command": "npx",
"args": ["-y", "@vrun-design/openflowkit-mcp"]
}
}
}Then restart the client to use the tools.
claude_desktop_config.json
{
"mcpServers": {
"openflowkit": {
"command": "npx",
"args": ["-y", "@vrun-design/openflowkit-mcp"]
}
}
}
Fit and risk
Not for
- Users needing real-time multi-user collaboration (collaboration is experimental and off by default).
- Users wanting GIF export (currently only MP4 is supported).
- Users needing a desktop application (not yet released).
Required permissions
- No API key required.
- No network requests needed; all operations run locally.
- May access local file system for codebase analysis.
Risks and side effects
- Early-stage software; may have bugs or changes in functionality.
- Codebase analysis may be inaccurate; AI-generated diagrams may require manual review.
- Local-first means data stays in the browser local storage; sharing requires exports or viewer links.
Troubleshooting
- If the MCP server fails to connect, check:
- 1. Ensure Node.js is installed and npx is available.
- 2. Check network connectivity to allow npx to download the package.
- 3. Reload the MCP client configuration to ensure it is correct.
Use cases
Create system architecture diagrams or flowcharts via natural language prompts in Claude or Cursor.
Analyze an existing codebase to produce architecture diagrams for better understanding.
Use templates to quickly generate standard diagrams, improving documentation efficiency.
Supported clients
Claude DesktopFull support
CursorFull support
WindsurfFull support