Astah Pro MCP：实现基于AI的UML建模
一个本地MCP服务器，作为UML建模工具Astah Professional的插件运行。此MCP服务器使AI代理能够：
- 设计系统并将其表示为UML模型。
- 解释UML模型。
- 从UML模型生成源代码，反之亦然。
- 从手绘草图创建UML图。
这些视频展示了Claude Code（作品4.6）设计一个简单的库管理系统，并绘制类图、序列图和活动图。它们以10倍速演奏。
提示： *设计一个简单的图书馆管理系统，并在Astah中绘制类图来说明其结构。*\ class-diagram.gif
提示： *根据Astah模型的内容，绘制一个序列图来说明借书的行为。*\ sequence-diagram.gif
提示： *基于Astah模型的内容，绘制一个活动图来说明归还书籍的行为。*\ activity-diagram.gif
上面视频中创建的图表：
需求
- Astah Pro v11.0或更高版本
- AI代理
- 对于完整（查询+编辑）工具版本：
随着over 300 此版本中公开的工具，请使用下面列出的AI代理。其他AI代理可能会因为大量的工具而无法连接，或者可能会连接但只识别一个子集。
- 克劳德代码 - Codex CLI - Gemini CLI
- 对于仅查询的工具版本：
此版本公开了 125 工具，因此许多AI代理可能能够使用它。请注意，AI代理只能引用有关模型元素和图表的信息。
> *备注*：此MCP服务器仅连接到与Astah Professional在同一台计算机上运行的AI代理。 > 根据Astah的使用条款，只有当您持有有效的许可证，并使用您的许可证Astah仅供自己使用时，才允许通过AI代理使用Astah。严禁允许未经许可的第三方通过此类代理运营Astah。\ > 有关详细信息，请参阅常见问题解答(英语 / 日语)或 联系Change Vision（Astah的开发者） 直接。
支持的图表类型
此MCP服务器可以查看和编辑以下图表：
- 类图
- 顺序图
- 活动图
- 状态机图
- 用例图
- 通信图 （仅限查询）
- 组合结构图 （仅限查询）
- ER图 （仅限查询）
- 思维导图
安装
安装Astah Pro
下载自 这里 并安装。
安装Astah Pro MCP插件
AI代理设置
要使用完整版工具，请指定端口 8888；要使用仅查询工具版本，请指定端口 8889.此外，使用 127.0.0.1 不 localhost.连接到 localhost 将失败。
克劳德代码
在项目目录中为项目范围运行此命令：
claude mcp add --transport http --scope project astah-pro-mcp http://127.0.0.1:8888/mcp或者为用户范围运行此命令：
claude mcp add --transport http --scope user astah-pro-mcp http://127.0.0.1:8888/mcpCodex CLI
创建 .codex/config.toml 在您的项目目录或用户目录下，使用：
[mcp_servers.astah-pro-mcp]
transport = "http"
url = "http://127.0.0.1:8888/mcp"
startup_timeout_sec = 10*注：* 如果您正在使用 *Codex CLI* 上 *WSL2* 在Windows中，您需要允许WSL访问Windows的127.0.0.1。所以，看 这里 并考虑启用镜像模式。
Gemini CLI
在项目目录中为项目范围运行此命令：
gemini mcp add --transport http --scope project astah-pro-mcp http://127.0.0.1:8888/mcp或者为用户范围运行此命令：
gemini mcp add --transport http --scope user astah-pro-mcp http://127.0.0.1:8888/mcp如何使用
- 启动Astah Pro
一些AI代理在启动时尝试连接到MCP服务器，因此启动Astah Pro 第一.
- 启动AI代理
在首次连接到Astah Pro MCP服务器时，系统会要求您进行确认。查看详细信息并单击 '连接'.\ Connection Request
- 向AI代理发送提示
如果要禁用Astah中的Astah Pro MCP插件，请单击\[插件\]>\[已安装插件\]，选择 *Astah Pro MCP* 在插件列表对话框中，单击禁用，然后重新启动Astah。
构建与测试
如果你想在本地构建和测试：
- 设置Astah插件开发环境（请参阅 这里).
- 构建：
astah-build- 运行测试（更改
astahPath到您的Astah Pro安装路径）：
在Windows 11上运行所有测试：
astah-mvn test -DastahPath="C:\Program Files\astah-professional"在Windows 11上运行特定测试：
astah-mvn test -DastahPath="C:\Program Files\astah-professional" -Dtest="**/editor/*Test"注意事项
实验状态
该项目目前 实验性的设计和实现可能会发生重大变化。
保密风险
Astah项目数据和日志将与AI代理共享。对于包含机密信息的Astah项目，要么避免使用此MCP服务器，要么仅在适当的保护措施下使用（例如，为AI代理启用退出设置）。
推荐备份
由于此MCP服务器编辑模型元素和图表，我们建议您将Astah项目提交到Git存储库，或在使用前和使用过程中制作副本，以便在必要时进行还原。
功能限制
某些模型或图表信息（例如某些属性）无法通过提供的工具功能查看或编辑。直接使用Astah GUI。
成本
此MCP服务器优先提供AI代理需要和执行的信息 不 实施代币节约措施。我们建议在 按时计价 计划而不是边做边付。
AI限制
与源代码一样，AI代理可能会出错或误解模型元素和图表。
许可证
此MCP服务器提供的一些工具功能返回以下摘录 OMG统一建模语言2.5.1, OMG SysML 1.7 规格，以及 FIPS酒吧184 IDEF1XOMG UML/SysML规范按照每份文档开头所述进行许可。FIPS PUB 184 IDEF1X是美国政府作品（NIST），在美国不受版权保护（17 U.S.C.§105），但可能受外国版权保护。当这些规范/文档的内容由工具函数返回时，它被明确地表示为摘录。“思维导图”是布赞组织有限公司的注册商标。
所有其他作品，包括源代码，版权归 田岛隆明 并在 MIT-0 许可证。\ 
收到功能请求或发现错误？
请打开 问题。因为这个项目是实验阶段，可能会引入突破性的更改，所以在设计和实现稳定之前，我们不会接受pull请求。谢谢你的理解。
需要支持？
如果您需要私人支持，请联系 takaaki.teshima.dev [at] gmail.com （替换 [at] 和 @).它可能成为一个付费项目；我也许还能支持你/它。