plantuml-validator

This MCP server validates PlantUML code. The Docker variant runs a container that exposes a service capable of receiving PlantUML, validating it, and returning either an OK response or detailed error information including descriptions and line numbers. To use, start the container (as shown in the installation instructions) and configure your editor (e.g., VSCode) to point to the MCP server via the provided settings. The server exposes a validation endpoint that accepts PlantUML data and returns validation results for integration with your development workflow.

Prerequisites:

• Docker installed on your machine (and Docker daemon running).
• Optional: Docker Compose if you prefer composing multiple services.

Installation steps:

1. Pull and run the PlantUML Validator MCP Server container: docker run --rm -d --name plantuml-validator-mcp-server --network=host kwhrkzk/plantuml-validator-mcp-server PlantumlBaseUrl=http://your_plantuml_server/

2. If you need to expose via VSCode or another client, configure the MCP server in your editor settings to point to the container’s PlantUML validation endpoint. Example placeholder in VSCode settings: { "mcp": { "servers": { "my-plantuml-mcp-server-docker": { "type": "stdio", "command": "docker", "args": [ "run", "--rm", "-i", "--network=host", "kwhrkzk/plantuml-validator-mcp-server", "PlantumlBaseUrl=http://your_plantuml_server/" ] } } } }

3. If you prefer building a local container image from source, follow the repository’s build instructions (usually a dotnet/publish step for the stdio/compose setup) and then run the produced container similarly.

Notes:

• The PlantUML Base URL must point to your PlantUML server instance that the validator will query if needed.
• The MCP client (e.g., VSCode MCP extension) should be configured with the server name (my-plantuml-mcp-server-docker) and the appropriate type (stdio) as shown in the README example.
• If you encounter networking issues, ensure --network=host is appropriate for your environment or adapt the run command to fit your network setup.
• The validator returns detailed error information for invalid PlantUML input to help you fix syntax or semantic issues in diagrams.