Repository navigation
Releases: Denmurzik/visual-paradigm-mcp-plugin
Release list
v0.4.3 – sequence messages keep their receiver
Sequence diagram messages lost their receiver. When a message ends on an activation bar, Visual Paradigm drops its receiver: the model's to end stays empty and the connector has no target shape. The diagram still looks right because the line keeps its stored points, but vp_get_element shows to: {}, and anything that reads the model (reports, code generation, checks of sender and receiver) sees messages without a receiver. vp_build_sequence attached almost every call and return to the receiver's activation bar, so nearly all its messages were affected.
vp_build_sequenceattaches both ends of a message to the lifelines; the activation bars are still linked to the messagevp_add_connector/ build connectors of typeMessagegiven an activation bar use its lifeline; activation shape ids fromvp_get_diagramare found- the label of a message from a lifeline to itself sits above its loop
Diagrams built with earlier versions keep their messages without a receiver: rebuild them with vp_build_sequence or re-create the affected messages. Arrow heads now reach the lifeline's centre line, about half an activation bar into it.
Install: close Visual Paradigm, replace the visual-paradigm-mcp-plugin folder in the plugins directory with the one from the zip, start VP. The skill (visual-paradigm-skill.zip) was updated as well.
v0.4.2 – shape sizes after reload, association roles, member types
Fixes found while building class and sequence diagrams for a real project.
Shapes losing their size after reopening a project. Shapes created through the plugin kept Visual Paradigm's "request default size" flag until the diagram was painted in an editor. A project saved before that came back with default-sized shapes (classes 80x40, names and members cut off), and exports of closed diagrams showed the same. Builds now clear the flag. When the tools open a closed diagram (builds, layouts, exports, vp_open_diagram), classes, tables and enumerations are fitted to their content without being made smaller, which also repairs diagrams that were already affected.
vp_export_diagram_imageopens a closed diagram before rendering it;vp_get_diagramreports whether the diagram is open (opened)vp_add_childrefits the owner's shapes, so new attributes/operations show up in the compartments- associations are reused only when the given role names, multiplicities and aggregation match: two compositions between the same classes with different roles are no longer merged; association ends are reported as
fromEnd/toEnd vp_get_elementshows attribute and parameter types (dataType) and operation return types (returnType, including[]);vp_find_elementsalso finds members (attributes, operations, parameters)- connectors:
waypoints(bend points) onvp_add_connector, build connectors andvp_update_element; a second line between the same two shapes is drawn with a bend automatically; new connectors are drawn between the shape borders instead of along the top edges vp_update_elementwith the project id renames the projectvp_list_typesaccepts a diagram type such asClassDiagram
Install: close Visual Paradigm, replace the visual-paradigm-mcp-plugin folder in the plugins directory with the one from the zip, start VP. The skill (visual-paradigm-skill.zip) was updated as well. Restart your agent session to load the new tool schemas.
v0.4.1 – fixes: flow steps, duplicate relationships, actor lists
Bug fixes and small improvements found while maintaining a real use case model.
vp_get_elementnow returns the steps of flows of events (they were always empty); sub-steps are returned as{text, steps}, and flows/steps can be looked up by idvp_set_use_case_details:replaceActors: truesets the exact, ordered primary/supporting actor lists (also clearing with an empty list); steps may contain sub-stepsvp_add_connector/vp_build_diagramreuse an identical existing relationship (same type, ends and name) instead of creating a duplicate in the model;allowDuplicate: trueforces a new one- elements shown again via
modelIdreport their real size immediately - «include»/«extend» labels on short, steep lines are placed beside the line instead of on the arrow head
Install: close Visual Paradigm, replace the visual-paradigm-mcp-plugin folder in the plugins directory with the one from the zip, start VP. The skill (visual-paradigm-skill.zip) was updated as well.
v0.4.0 – full sequence diagram support
Sequence diagrams
New tool vp_build_sequence builds a complete sequence diagram in one call from participants and ordered steps:
- lifelines with classifiers (
form : OrderForm) and actors - synchronous calls, replies (dashed, unnumbered), async messages, self calls,
create(the new object starts at the message) anddestroy(X) - activation bars derived automatically from call/return pairs
- combined fragments
alt,opt,loop,par,break,critical,neg, ... with guarded operands, nestable - interaction uses (
ref), optionalsdframe and sequence numbers
Also: vp_get_view (presentation properties of a shape/diagram), diagram options through vp_update_element view, connector points in vp_get_diagram.
Install
Close Visual Paradigm, unzip into %APPDATA%\VisualParadigm\plugins (Linux: ~/.config/VisualParadigm/plugins), start VP. Restart your Claude Code session to load the new tools.
Skill (recommended)
visual-paradigm-skill.zip contains the visual-paradigm skill: workflow, UML conventions, checking results, dialogs and tested examples for every diagram type. Unzip it into your client's skills folder: ~/.claude/skills/ (Claude Code), ~/.codex/skills/ (Codex CLI), ~/.config/opencode/skills/ (OpenCode) or ~/.gemini/antigravity/skills/ (Antigravity CLI). MCP setup commands for all four clients are in the README.
v0.3.0 – class models, dialog handling
Class models
Interface,Enumeration(with literals),DataTypeas element types- attributes and operations with parameters, static/abstract members, initial values
- association roles, multiplicities, navigability, aggregation/composition, qualifiers, association classes
- stereotypes on any element (
stereotypes,removeStereotypes);view: {"displayStereotypeIcon": false}shows «entity» classes as boxes - a type can reference a class by name, id or
@keyof the samevp_build_diagramcall; elements can be referenced by unique name - new layout
layered(default for class/ER diagrams): inheritance top-down, no clipped classes
Dialogs
vp_list_dialogs/vp_press_dialog_button: the AI can read and answer dialogs Visual Paradigm opens (save changes, project recovery…)
Install
Close Visual Paradigm, unzip into %APPDATA%\VisualParadigm\plugins (Linux: ~/.config/VisualParadigm/plugins), start VP. Restart your Claude Code session to load the new tools.
v0.2.0 – Visual Paradigm 18.1 / Java 11
First release of the rewrite for Visual Paradigm 18.1 (also the free Community Edition).
Install
- Close Visual Paradigm.
- Unzip
visual-paradigm-mcp-plugin-0.2.0.zipinto the plugins folder so that you get<plugins>/visual-paradigm-mcp-plugin/plugin.xml- Windows:
%APPDATA%\VisualParadigm\plugins - Linux:
~/.config/VisualParadigm/plugins
- Windows:
- Start Visual Paradigm, then connect your MCP client, e.g. Claude Code:
claude mcp add --transport http -s user visual-paradigm http://127.0.0.1:8931/mcp
What's inside
- 22 MCP tools (Streamable HTTP on
127.0.0.1:8931/mcp, configurable inmcp.properties) - Use case, activity (swimlanes), sequence, class, ER and state machine diagrams; many shapes and connectors in one call; image export so the AI can look at the result
- No dependencies, runs on Visual Paradigm's bundled Java 11
Tested on Windows 11 with Visual Paradigm Community Edition 18.1 (build 20260914).