Astah Pro MCP Skill 技能

技能简介

Astah Pro MCP 是一款本地运行的 MCP（Model Context Protocol）服务器插件，专门为 Astah Professional 这款专业 UML 建模工具打造。它让 AI 编程助手能够直接操控 Astah Pro，完成系统设计、代码生成、架构图绘制等任务，无需人工在图形界面中反复操作。开发者只需通过自然语言描述需求，AI 即可驱动插件完成从设计到代码的全流程。

核心能力

Astah Pro MCP 提供以下核心能力：

1. 系统设计与 UML 建模：AI 助手可以设计系统架构，并用 UML 类图呈现完整结构。
2. UML 模型解读：上传已有 Astah 项目文件，AI 自动解析并解释其中的模型关系。
3. 正向工程：从 UML 类图直接生成对应语言的源代码。
4. 逆向工程：导入源代码文件，AI 自动生成对应的类图和时序图。
5. 手绘草图识别：拍摄手绘的 UML 草图，AI 驱动插件自动转换为规范的专业 UML 图表。
6. 多图类型支持：支持类图、时序图、活动图、状态机图、用例图、Mind Map、需求图、复合结构图、通信图、ER 图等十余种图表。
7. 程序化工具调用：采用 Anthropic 提出的「程序化工具调用」模式，AI 可批量调用 83 个工具函数进行复杂建模操作。

安装配置

前置条件

• Astah Professional v12.0 或更高版本（需自行下载安装并持有有效许可证）
• Claude Code、Codex CLI、Grok Build、Antigravity CLI、Cursor IDE、Antigravity IDE 或 Kiro IDE 等支持 MCP 的 AI 编程助手

安装步骤

第一步：下载并安装 Astah Professional

从 Astah 官网（https://astah.net/downloads/）下载并安装 Astah Professional v12.0 或更高版本。

第二步：下载 MCP 插件 JAR 文件

从 GitHub Releases 页面（https://github.com/takaakit/astah-pro-mcp/releases）下载最新的 astah-pro-mcp-x.x.x.jar 文件。

第三步：安装插件到 Astah

将下载的 JAR 文件复制到 Astah 安装目录的插件文件夹中，然后重启 Astah。如果 Extra View 中出现 MCP 选项卡，说明插件安装成功。

第四步：在 AI 编程助手中配置 MCP 服务器

以 Claude Code 为例，运行以下命令添加 Astah Pro MCP：

Claude Code 用户（项目级）：

claude mcp add --transport http --scope project astah-pro-mcp http://127.0.0.1:8888/mcp

Codex CLI 用户：在项目目录或用户目录下创建 .codex/config.toml 文件，添加：

[mcp_servers.astah-pro-mcp]
transport = "http"
url = "http://127.0.0.1:8888/mcp"

使用步骤

启动连接流程

第一步：先启动 Astah Pro

由于部分 AI 编程助手会在启动时尝试连接 MCP 服务器，建议先启动 Astah Pro，再启动 AI 助手。

第二步：启动 AI 编程助手并发起新会话

每次 AI 助手与 Astah Pro MCP 服务器建立新会话时，Astah 会弹出连接确认对话框，请仔细审查连接详情后点击「连接」确认。

第三步：发送建模指令

连接成功后，即可通过自然语言向 AI 助手下达 UML 建模指令。例如：

• 「设计一个图书馆管理系统，在 Astah 中绘制其类图」
• 「基于当前 Astah 模型，绘制借书操作的时序图」
• 「将当前类图转换为 Python 源代码」

第四步：查看并调整建模结果

在 Astah Pro 中查看 AI 生成的 UML 图表或源代码，确认无误后继续下一步操作。如需修改，可直接在 Astah 中调整或再次向 AI 助手描述修改需求。

禁用插件

如需临时禁用 Astah Pro MCP 插件，在 Astah 中点击「插件」→「已安装插件」，在列表中选择 Astah Pro MCP，点击「禁用」，然后重启 Astah 即可。

适用场景

Astah Pro MCP 适用于以下场景：

1. 架构设计阶段：在系统设计初期，用 AI 辅助绘制类图、时序图等架构图，快速迭代方案。
2. 代码文档化：将现有代码逆向生成为 UML 图，帮助团队快速理解遗留系统结构。
3. 团队协作沟通：生成的 UML 图可作为团队内外的技术沟通素材，降低理解门槛。
4. AI 编程工作流：在 Claude Code 等 AI 编程助手中集成 UML 建模能力，让 AI 在编写代码前先设计架构。

适用人群

• 使用 Astah Pro 进行 UML 建模的软件架构师和开发团队
• 使用 Claude Code、Codex CLI 等 AI 编程助手的开发者
• 需要快速从设计文档生成代码，或从代码反向生成架构图的工程师
• 软件工程教学场景中需要演示设计到实现全流程的教师和学员

工作原理

Astah Pro MCP 基于 Anthropic 在《Advanced Tool Use》文章中提出的「程序化工具调用」（Programmatic Tool Calling）理念构建。插件在本地运行两个端口：8888（程序化工具调用模式，暴露 83 个工具函数）和 18888（直接工具调用模式，暴露 398 个工具函数）。AI 编程助手通过 MCP 协议与插件通信，插件再调用 Astah Pro 的底层 API 完成建模操作。插件支持 Claude Code、Codex CLI、Grok Build、Cursor IDE 等多种 AI 编程环境。

官方链接

• GitHub 仓库：https://github.com/takaakit/astah-pro-mcp
• Astah Professional 下载：https://astah.net/downloads/
• 许可证：MIT-0（可免费商用，且无需标注来源）