plantumlweb

1# plantuml_web
2[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/2niuhe/plantuml_web)](https://archestra.ai/mcp-catalog/2niuhe__plantuml_web)
3Using nicegui as a PlantUML frontend, you can deploy PlantUML on an intranet.
4 
5It's a nicegui demo project with an added MCP (Model Context Protocol) server that exposes PlantUML functionality to AI assistants.
6 
7Plantuml jar version: plantuml-1.2025.3.jar
8 
9![demo](https://github.com/2niuhe/plantuml_web/blob/main/demo_img/demo.png)
10 
11## Features
12 
13### Web Interface
14- Interactive PlantUML editor with live preview
15- Save and load diagrams
16- Responsive UI with resizable panels
17 
18### MCP Server
19- Generate PlantUML diagrams in SVG or PNG format
20- Validate PlantUML code with detailed error messages
21 
22## Usage:
23 
24### With Docker
25 
26```shell
27docker build -t plantuml_web_mcp .
28 
29# or pull from dockerhub
30# docker pull  2niuhe/plantuml_web_mcp:latest
31 
32docker run -d -p 8080:8080 -p 8765:8765 plantuml_web_mcp:latest
33```
34 
35Then you can access:
36- Web interface: http://127.0.0.1:8080
37- MCP server: http://127.0.0.1:8765/sse
38 
39### Without Docker
40 
41```shell
42pip install -r requirements.txt
43sh start.sh
44```
45 
46The start script will launch:
471. PlantUML server on port 8000
482. Web interface on port 8080
493. MCP server on port 8765
50 
51## Connecting to the MCP Server
52 
53You can connect to the MCP server using any MCP client, such as Claude Desktop:
54 
551. Open Claude Desktop
562. Go to Settings > MCP Servers
573. Add a new server with the URL: `http://localhost:8765/sse`
584. Restart Claude Desktop
59 
60## Testing the MCP Server
61 
62A test client is provided to verify the MCP server functionality:
63 
64```shell
65python test_plantuml_mcp.py http://localhost:8765/sse
66```
67 
68 
69 
70## Available MCP Tools
71 
72- `generate_plantuml_image`: Generate a diagram image from PlantUML code
73- `validate_plantuml_syntax`: Validate PlantUML code and return validation result
74 
75 
76### ref
77 
78[Home · zauberzeug/nicegui Wiki](https://github.com/zauberzeug/nicegui/wiki)
79 
80[How to use nicegui for beginners？ · zauberzeug/nicegui · Discussion #1486](https://github.com/zauberzeug/nicegui/discussions/1486)
81 
82[Nicegui example and suggestions · zauberzeug/nicegui · Discussion #1778](https://github.com/zauberzeug/nicegui/discussions/1778)
83 
84[NiceGUI](https://nicegui.io/documentation)
85 
86[syejing/nicegui-reference-cn: NiceGUI 中文版本文档](https://github.com/syejing/nicegui-reference-cn?tab=readme-ov-file)
87 
88[(1) Use NiceGUI to watch images and do it from the COMMAND LINE! - YouTube](https://www.youtube.com/watch?v=eq0k642zQQ8)
89