Uml MCP

UML-MCP：通过MCP生成图表

 ](https://github.com/antoinebou12/uml-mcp/actions/workflows/build.yml)  ](https://github.com/antoinebou12/uml-mcp/stargazers)   

通过以下方式生成UML和其他图表 模型上下文协议.

概览

快速开始

选择您的模式

• 远程（推荐）： 使用Vercel无服务器运行时通过HTTP MCP快速设置
• 当地： 用于文件输出和本地调试的stdio进程

远程快速启动（Vercel HTTP MCP）

公共Vercel部署的配置：

"uml-mcp": {
  "transport": "http",
  "url": "https://uml-mcp.vercel.app/mcp"
}

本地快速启动（stdio MCP）

git clone https://github.com/antoinebou12/uml-mcp.git && cd uml-mcp
uv sync
uv run python server.py

客户端配置示例：

• config/cursor_config.json
• config/claude_desktop_config.json
• config/README.md 获取准确的配置文件位置
• 克劳德代码： 从repo市场安装捆绑的插件（见下文）或阅读 docs/integrations/claude_code.md

Claude代码插件

添加托管HTTP MCP服务器以及图表技能（否 settings.json 粘贴）。在克劳德代码中：

/plugin marketplace add https://github.com/antoinebou12/uml-mcp
/plugin install uml-mcp@uml-mcp-plugins

如果您已经克隆了此仓库，请使用本地路径而不是GitHub URL。自定义端点和验证： docs/integrations/claude_code.md.

远程vs本地

• 运输： 默认情况下，远程使用HTTP MCP，本地使用stdio
• 运行时间： 远程运行在Vercel上，本地运行在Python环境中
• 文件写入： 远程是只读的（否 output_dir)，本地支持 output_dir
• 返回的数据： 两者都返回URL+base64；本地也可以保存文件
• 环境变量： 远程由服务器端管理；本地读取您的env配置

MCP客户端必须致电 /mcp，而不是网站根。

支持的图表类型

支持格式的完整列表：运行 python server.py --list-tools 或查询 uml://types 和 uml://formats.

MCP工具和资源

工具

资源(uml://)

部署

维塞尔

此回购包括 vercel.json 用于无服务器部署。

1. 将仓库连接到 维塞尔
2. 使用 `https://

.vercel.app/mcp`

1. 保持 /mcp 在所有MCP客户端URL中

铁匠铺

1. 打开 史密斯·艾/新，选择 统一资源定位符
2. 进入 `https://

.vercel.app/mcp`

1. 配置显示名称、描述和主页

详细指南： docs/integrations/vercel_smithery.md

码头工人

默认映像通过MCP HTTP在端口8000上为FastAPI提供服务 http://127.0.0.1:8000/mcp.

# Full local stack (local Kroki + mermaid + blockdiag)
docker compose up -d

# API + MCP only (public Kroki)
docker build -t uml-mcp . && docker run -p 8000:8000 uml-mcp

# stdio MCP subprocess mode
docker run -i uml-mcp python server.py --transport stdio

配置（本地运行时）

这些变量适用于本地/自托管运行。远程Vercel端点设置由服务器端管理。

完整选项： docs/configuration.md

建筑

当用户向启用MCP的助手询问图表时的典型流程：助手呼叫 generate_uml，服务器通过Kroki进行渲染，然后向用户的助手返回URL和可选的base64。

server.py              -- MCP entry point (stdio/HTTP)
app.py                 -- FastAPI REST API + MCP HTTP at /mcp
api/app.py             -- legacy re-export of root app (Vercel FastAPI preset uses root app.py)
mcp_core/
  core/                -- config, server, CLI, utilities, diagram pipeline
  tools/               -- generate_uml, validate_uml
  prompts/             -- diagram generation prompts
  resources/           -- uml:// resource handlers
tools/kroki/           -- Kroki, PlantUML, Mermaid, D2 clients

发展

# Install dev dependencies
uv sync --all-groups

# Run tests
uv run pytest tests/ -v

# Lint
uv run ruff check . && uv run ruff format --check .

# Local CI
make ci

文档

• 在线的:
• 本地: uv run mkdocs serve 然后打开 http://127.0.0.1:8000

贡献

• 贡献指南
• 行为准则
• 安全策略

许可证

麻省理工学院

致谢

PlantUML | 克罗基 | 美人鱼 | 第2页

明星历史