Visual Paradigm MCP Plugin

A Model Context Protocol (MCP) server plugin for Visual Paradigm that provides AI applications with seamless integration to Visual Paradigm’s modeling and diagramming modeling capabilities. The MCP server is embedded directly within the Visual Paradigm plugin, starting automatically when the plugin loads.

Architecture

• Spring AI 1.1.0-M1: Model Context Protocol server integration
• Visual Paradigm 17.2: UML modeling platform integration
• Maven: Build automation and dependency management
• MCP Transport: Streamable HTTP communication with MCP clients
• Visual Paradigm Plugin API: Integration with Visual Paradigm’s modeling capabilities
• JUnit & Mockito: Comprehensive testing framework

Features

MCP Server Integration

The plugin includes an embedded MCP server that:

• Auto-starts when Visual Paradigm plugin is loaded
• Auto-stops when Visual Paradigm plugin is unloaded
• Runs on port 8080 with SSE endpoint /mcp/messages
• Provides tool capabilities for external MCP clients

Available MCP Tools

• createUseCaseDiagram(diagramName): Create new use case diagrams
• addActor(actorName, diagramName): Add actors to specific diagrams
• addUseCase(useCaseName, diagramName): Add use cases to diagrams
• addRelationship(actorName, useCaseName, relationshipType): Create relationships between actors and use cases
• generateReport(diagramName): Generate reports for use case diagrams

Future MCP Features (Planned)

Resources

• Server Status: Monitor MCP server health and connection status
• Project Information: Retrieve current project details
• Diagram Metadata: Access diagram properties and structure

Prompts

• Use Case Templates: Generate standard use case patterns
• Diagram Validation: Check diagram completeness and consistency

Plugin User Interface

• Toggle MCP Server: Start/stop the MCP server from Visual Paradigm toolbar
• Server Status: View detailed MCP server status and capabilities

Plugin Integration

• Automatic Lifecycle Management: MCP server starts/stops with plugin
• Error Handling: Robust startup/shutdown with detailed logging
• Spring Boot Integration: Full Spring framework capabilities within Visual Paradigm

Usage

Installation

Build, test and install with the ./run command:

1. Build the plugin:

   ./run build
   

2. Package for distribution:

   ./run package
   

3. Install to Visual Paradigm:

   ./run install
   

4. Start Visual Paradigm - the MCP server will start automatically

Using the MCP Server

Once Visual Paradigm is running with the plugin:

• MCP Server Endpoint: http://localhost:8080/mcp/messages (SSE)
• Server Name: visual-paradigm-use-case-mcp-server
• Available Tools: 5 use case diagram operations

Connecting with Claude or MCP Clients