Flowzap MCP

🚀 FlowZap MCP 服务器

FlowZap MCP 服务器可借助 Claude、Cursor、Windsurf 等 8 种以上支持 MCP 的工具，利用 AI 助手创建工作流、序列和架构图。

FlowZap 是一款可视化工作流绘图工具，拥有名为 FlowZap 代码 的基于文本的领域特定语言（DSL）。此 MCP 服务器能让 AI 助手为你创建图表。

🚀 快速开始

FlowZap 借助 FlowZap 代码 DSL 将文本提示转化为三重视图图表（工作流、序列和架构）。它既不是 Mermaid，也不是 PlantUML，而是一种专为简化和 AI 生成设计的独特领域特定语言。

✨ 主要特性

关键特性

• 仅使用 4 种形状：圆形、矩形、菱形、任务框
• 节点属性使用冒号：label:"文本"
• 边标签使用等号：[label="文本"]
• 处理句柄：n1.handle(right) -> n2.handle(left)
• 序列图质量：每个跨泳道请求都需要匹配的响应边；按时间顺序定义边；无孤立节点

📦 安装指南

FlowZap MCP 服务器可与任何支持模型上下文协议（MCP）的工具配合使用：

所有兼容的编码工具

不兼容的工具：Replit 和 Lovable.dev 仅支持通过 URL 访问的远程 MCP 服务器。请使用 公共 API 代替。

JSON 配置

所有工具都使用相同的 JSON 配置格式：

{
  "mcpServers": {
    "flowzap": {
      "command": "npx",
      "args": ["-y", "flowzap-mcp"]
    }
  }
}

Windows 用户：如果工具未显示，请使用绝对路径：

"command": "C:\\Program Files\\nodejs\\npx.cmd"

使用 where.exe npx 查找你的 npx 路径。

🔧 可用工具

核心工具

以代理为中心的工具

💻 使用示例

基础图表创建

向你的 AI 助手提出以下请求：

• "生成此应用中当前登录流程的序列图"
• "为订单处理系统创建工作流图"
• "为微服务 API 网关创建架构图"
• "制作显示用户注册流程的流程图"
• "绘制包含构建、测试和部署阶段的 CI/CD 管道图"

以代理为中心的工作流

将 HTTP 日志解析为图表：

"这是我的 nginx 访问日志。创建一个显示请求流程的序列图。"

代理使用 flowzap_artifact_to_diagram 并指定 artifactType: "http_logs"。

分析图表结构：

"此工作流中哪些步骤涉及数据库？"

代理使用 flowzap_export_graph 获取 JSON 图，然后进行查询。

显示更改内容：

"我更新了工作流。与上一版本有何不同？"

代理使用 flowzap_diff 比较新旧代码。

安全增量更新：

"在此图表的 API 调用后添加一个日志记录步骤。"

代理使用 flowzap_apply_change 应用结构化补丁，而不是重新生成。

助手将执行以下操作：

1. 根据你的描述生成 FlowZap 代码
2. 验证代码
3. 创建具有适当视图（工作流、序列或架构）的游乐场 URL，以便查看和共享

基础用法

sales { # 销售团队
  n1: circle label:"订单已接收"
  n2: rectangle label:"验证订单"
  n3: diamond label:"是否有效？"
  n1.handle(right) -> n2.handle(left)
  n2.handle(right) -> n3.handle(left)
  n3.handle(right) -> fulfillment.n4.handle(left) [label="是"]
}

fulfillment { # 履行
  n4: rectangle label:"处理订单"
  n5: circle label:"完成"
  n4.handle(right) -> n5.handle(left)
}

🔧 技术细节

安全特性

• 无需身份验证 - 仅使用公共 FlowZap API
• 不访问用户数据 - 无法读取你的图表或账户信息
• 本地运行 - MCP 服务器在你的机器上运行
• 防止 SSRF - 仅连接到 flowzap.xyz
• 速率限制 - 客户端每分钟限制 30 个请求
• 输入验证 - 最大代码大小为 50KB

代理技能

通过 skills.sh 为 40 多种兼容的编码代理安装 FlowZap 技能：

npx skills add flowzap-xyz/flowzap-mcp

• skills.sh 列表：https://skills.sh/flowzap-xyz/flowzap-mcp/flowzap-diagrams
• 技能源代码：skills/flowzap-diagrams/
• 兼容以下工具：Claude 代码、Cursor、Windsurf、Codex、Gemini CLI、GitHub Copilot、Cline、Roo 代码、Augment、OpenCode 等。

📚 详细文档

相关链接

• FlowZap 网站
• FlowZap 代码文档
• FlowZap MCP 博客
• 大语言模型上下文
• 模板库
• npm 包
• GitHub 仓库

📄 许可证

本项目采用 MIT 许可证。