Plantuml Sld MCP Server

PlantUML SLD MCP服务器

MCP服务器，用于使用PlantUML生成电气单线图（SLD）。

特性

• 从YAML拓扑定义生成SLD图
• 从加载列表技能输出引导拓扑
• 支持多种分布模板（径向、冗余、生成器）
• 系统视图（折叠）和详细视图（展开）渲染
• 用于协作的可共享PlantUML URL
• 机器可读的YAML拓扑作为真理的来源

安装

# Using uv
uv pip install -e .

# With optional pandapower analysis
uv pip install -e ".[analysis]"

# With dev dependencies
uv pip install -e ".[dev]"

PlantUML后端

服务器需要PlantUML后端。安装以下之一：

1. 原生二进制 （推荐）：

   apt install plantuml

1. Java JAR:

   export PLANTUML_JAR=/path/to/plantuml.jar

1. 码头工人:

   docker pull plantuml/plantuml

MCP工具

用法

Claude代码配置

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "plantuml-sld": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/plantuml-sld-mcp-server", "plantuml-sld-mcp"]
    }
  }
}

工作流示例

1. 从加载列表启动:

   # Use sld_bootstrap_from_loadlist with load-list.yaml
   # Choose distribution template: single_utility_radial

1. 验证拓扑:

   # Use sld_validate_topology to check for errors

1. 生成图表:

   # Use sld_generate_diagram for PNG/SVG output
   # Or sld_encode_plantuml for shareable URL

拓扑架构

看 schemas/sld-topology.schema.yaml 在配电技能方面掌握完整的方案。

关键组件

• 公交车：主配电盘、MCC、配电盘
• 设备：公用设施、变压器、断路器、电机、变频器
• 连接：馈线、汇流排、控制电路

分发模板

视图模式

• 系统视图：满载的公共汽车倒塌
• 详细视图：每辆公交车配备独立馈线和设备

发展

# Run tests
pytest

# Run with coverage
pytest --cov=src

# Lint
ruff check src tests

工作流集成

此服务器是puran水电工程工作流程的一部分：

┌─────────────────────────┐     ┌──────────────────────────┐     ┌─────────────────────┐
│  equipment-list-skill   │ ──► │    load-list-skill       │ ──► │ electrical-         │
│  (equipment + power_kw) │     │    (FLC, protection,     │     │ distribution-skill  │
└─────────────────────────┘     │     MCC schedules)       │     │ (SLD generation)    │
                                └──────────────────────────┘     └─────────────────────┘
                                             │                              │
                                             │                              ▼
                                             │                   ┌─────────────────────┐
                                             └──────────────────►│ plantuml-sld-mcp    │
                                                                 │ (this server)       │
                                                                 └─────────────────────┘
                                                                            │
                                                                            ▼
                                                                 ┌─────────────────────┐
                                                                 │ PlantUML PNG/SVG    │
                                                                 │ + shareable URLs    │
                                                                 └─────────────────────┘

相关项目

上游（数据源）

• 加载列表技能 -符合NEC/IEC标准的电气负载清单，包括MCC表
• 设备清单技能 -设备清单，包括额定功率和馈线类型

同伴技能

• 配电技能 -编排此MCP服务器的Claude代码技能

相似的方式

• plantuml-csa-mcp服务器 -控制系统架构图（相同的YAML→ PlantUML模式）
• csa图技能 -使用plantuml-CSA-mcp服务器的CSA技能

许可证

麻省理工学院许可证-Puran Water