STARWARCLOUD STARWAR.AI
返回市场
阿斯塔赫专业版MCP

阿斯塔赫专业版MCP

作者：takaakit7 星标更新：2025-11-21
安装使用来源：spider==github.com

项目介绍

由AI代理驱动的UML建模——Astah Pro MCP

一个作为Astah Professional插件运行的本地MCP服务器。此MCP服务器使您能够执行以下操作及更多：

  • 使用AI设计系统，并在Astah中将其表示为UML模型和图表。
  • 要求AI解释Astah项目中的UML模型和图表。
  • 从Astah项目中的UML模型和图表生成源代码，反之亦然。
  • 从手绘草图图像在Astah中创建UML图表。
<br>

以下视频展示了Claude Code设计一个简单的图书馆管理系统并绘制类图、序列图和活动图的过程。这些视频加速了5倍。

提示：设计一个简单的图书馆管理系统并在Astah中绘制类图来表示其结构。
class-diagram.gif

提示：绘制一个序列图以说明借书的行为。
sequence-diagram.gif

提示：绘制一个活动图以说明还书的行为。
activity-diagram.gif

<br>

*注意：*截至2025年10月10日，AI助手/代理在查看和编辑模型信息方面表现良好，但在查看和编辑视觉图表信息方面仍在发展中。

<br>

系统需求

  • 需要Astah Professional v10.1或更高版本。此插件不适用于Astah UML。

  • 推荐的AI助手/代理

    • 用于使用全功能（查询+编辑）工具版本： 在此版本中暴露了超过200个工具，请使用下面列出的AI助手/代理。其他AI助手/代理可能由于工具数量过多而无法连接，或者即使连接上也只能识别部分工具。

      • Claude Desktop
      • Claude Code
      • Codex CLI
      • Gemini CLI

      如果希望AI助手/代理编辑模型或图表，请使用此版本。

    • 用于仅查询工具版本： 此版本暴露了大约100个工具，因此许多AI助手/代理可能会能够使用此插件。

      在此版本中，AI助手/代理只能引用关于模型和图表的信息。

    <br>

    *注意：*此MCP服务器仅连接到与Astah Professional在同一台机器上运行的AI助手/代理。 根据Astah的使用条款，只有持有有效许可证且仅通过AI助手/代理访问自己授权的Astah的情况下才允许使用Astah。不允许未授权的第三方通过此类助手/代理操作Astah。 详情请参阅常见问题解答（英文 / 日文）或直接联系Change Vision（Astah的开发者）(联系方式）。

<br>

支持的图表类型

此MCP服务器可以查看和编辑以下图表（未来还将支持更多）：

  • 类图
  • 序列图
  • 活动图
  • 状态机图
<br>

安装

安装Astah Professional

从这里下载并安装。

安装astah-pro-mcp插件

下载插件JAR文件（astah-pro-mcp-x.x.x.jar），将其放入Astah中，然后重启Astah（参见此处）。重启后，如果在Astah的扩展视图中看到一个**'mcp'**标签，则安装成功。

mcp标签

AI助手/代理设置

要使用全功能工具版本，请指定端口8888；要使用仅查询工具版本，请指定端口8889。

Claude Desktop

<details> <summary><code>claude_desktop_config.json</code></summary> 
{
  "mcpServers": {
    "astah-pro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://127.0.0.1:8888/mcp",
        "--allow-http"
      ]
    }
  }
}
</details>

截至2025年10月10日，可流式传输HTTP连接到本地MCP服务器在Claude Desktop中似乎工作不佳。请使用诸如mcp-remote之类的桥梁，这需要Node.js v20或更高版本。

Claude Code

<details> <summary><code>.mcp.json</code></summary> 
{
  "mcpServers": {
    "astah-pro-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8888/mcp"
    }
  }
}
</details>

或者运行以下命令：

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

有关--scope标志的信息，请参阅此处。

Codex CLI

<details> <summary><code>config.toml</code></summary> 
[mcp_servers.astah-pro-mcp]
command = "npx"
args = ["mcp-remote@latest", "http://127.0.0.1:8888/mcp", "--allow-http"]
</details>

截至2025年10月10日，可流式传输HTTP连接到本地MCP服务器在Codex CLI中似乎工作不佳。请使用诸如mcp-remote之类的桥梁，这需要Node.js v2_0或更高版本。

Gemini CLI

<details> <summary><code>settings.json</code></summary> 
{
  "mcpServers": {
    "httpServer": {
      "httpUrl": "http://127.0.0.1:8888/mcp",
      "timeout": 5000
    }
  }
}
</details>

<span style="color: red;">截至2025年11月21日，此问题阻止了Gemini CLI连接。</span>

Cursor

<details> <summary><code>mcp.json</code></summary> 
{
  "mcpServers": {
    "astah-pro-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8889/mcp"
  }
}
</details>

VSCode (Copilot)

<details> <summary><code>mcp.json</code></summary> 
{
  "servers": {
    "astah-pro-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8889/mcp"
    }
  }
}
</details> <br>

*注意：*请使用127.0.0.1而不是localhost。连接到localhost将会失败。

<br>

如何使用

  1. 启动Astah（启动Astah也会启动MCP服务器）。 某些AI助手/代理在启动时会尝试连接到MCP服务器，所以请先启动Astah。

  2. 启动AI助手/代理。 在首次连接到MCP服务器时，系统会要求您确认。请检查详细信息并点击**'连接'**。 连接请求

  3. 向AI助手/代理发送提示。

如果您想在Astah中禁用此插件，请点击[插件] > [已安装插件]，在插件列表对话框中选择Astah Pro MCP条目，点击禁用，然后重新启动Astah。

<br>

故障排除：如果Claude Desktop无法连接到MCP服务器，请完全退出Claude Desktop（例如，在任务管理器中结束'Claude'进程），然后重新启动它。

<br>

构建与测试

如果您想本地构建和测试：

  1. 设置您的Astah插件开发环境（参见此处）。

  2. 构建：

    astah-build

  3. 运行测试（更新astahPath以匹配您的Astah Professional安装路径）：

    在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"
<br>

考虑事项

实验性质

此项目目前处于实验阶段。设计和实现可能会发生重大变更。

保密风险

Astah项目数据和日志将与AI助手/代理共享。对于包含机密信息的Astah项目，要么避免使用此MCP服务器，要么仅在采取适当防护措施的情况下使用（例如，启用AI助手/代理的退出选项）。

建议备份

因为此MCP服务器会编辑模型和图表，我们建议将Astah项目提交到Git仓库或在使用前后进行复制，以便必要时可以回滚。

功能限制

某些模型或图表信息（例如，某些属性）不能通过提供的工具功能查看或编辑。请直接使用Astah GUI进行这些操作。

成本

此MCP服务器优先提供AI助手/代理所需的信息，而不实施节省令牌的措施。我们建议使用AI助手/代理的固定费用计划，而不是按需付费。

AI限制

如同源代码一样，AI助手/代理可能会犯错或误解UML模型和图表。

<br>

许可证

此MCP服务器提供的某些工具功能返回摘自OMG UML 2.5.1和OMG SysML 1.7规范的摘录。这些规范的许可方式如每个文档开头所述。当工具功能返回此类材料时，会明确指出它是摘录。

所有其他源代码由Takaaki Teshima拥有版权，并根据MIT-0许可证发布。 许可证：MIT-0

<br>

功能请求或发现错误？

请打开一个问题。因为此项目仍处于实验阶段并且可能会引入重大变更，我们暂不接受拉取请求，直到设计和实现稳定为止。感谢您的理解。

<br>

需要支持？

如果您需要私人支持，请联系takaaki.teshima.dev [at] gmail.com（将[at]替换为@）。这可能会成为一个付费项目；我仍然可能为您提供/该项目的支持。