Flowzap

FlowZap MCP Server

使用 Claude、Cursor、Windsurf 等 AI 助手及另外 8 种兼容 MCP 的工具，创建工作流、序列、架构和思维导图。

FlowZap 是一款可视化工作流绘图工具，采用名为 FlowZap Code 的文本 DSL。此 MCP 服务可让 AI 助手为你创建图表。

什么是 FlowZap？

FlowZap 使用 FlowZap Code DSL，将文本提示词转换为四视图图表（工作流、序列、架构和思维导图）。它不是 Mermaid，也不是 PlantUML，而是一种专为简洁易用和 AI 生成而设计的独特领域专用语言。

关键事实：

• 仅有 4 种形状：circle、rectangle、diamond、taskbox
• 节点属性使用冒号：label:"Text"
• 边标签使用等号：[label="Text"]
• 必须使用句柄：n1.handle(right) -> n2.handle(left)
• 泳道显示标签必须与左花括号在同一行：laneName { # Label
• 序列图质量：每个跨泳道请求都需要在下一个主要请求之前有相应的响应边；按时间顺序定义边；严格遵循“请求 → 响应 → 下一个请求”的节奏；不要留下孤立节点

安装

FlowZap MCP Server 适用于任何支持 Model Context Protocol（MCP）的工具：

所有兼容的编码工具

工具	配置方法
Claude Desktop	添加到 claude_desktop_config.json： macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json
Claude Code	运行：claude mcp add --transport stdio flowzap -- npx -y flowzap-mcp 或添加到项目根目录下的 .mcp.json。
Cursor	打开 Settings → Features → MCP Servers → Add Server。使用相同的 JSON 配置。
Windsurf IDE	添加到 ~/.codeium/windsurf/mcp_config.json
OpenAI Codex	添加到 ~/.codex/config.toml： [mcp_servers.flowzap] command = "npx" args = ["-y", "flowzap-mcp"] 或运行：codex mcp add flowzap -- npx -y flowzap-mcp
Warp Terminal	Settings → MCP Servers → 点击“+ Add”→ 粘贴 JSON 配置。
Zed Editor	添加到 settings.json： {"context_servers": {"flowzap": {"command": "npx", "args": ["-y", "flowzap-mcp"]}}}
Cline（VS Code）	打开 Cline 侧边栏 → MCP Servers 图标 → 编辑 cline_mcp_settings.json
Roo Code（VS Code）	添加到项目或全局设置中的 .roo/mcp.json。
Continue.dev	创建 .continue/mcpServers/flowzap.yaml，内容如下： name: FlowZap mcpServers: - name: flowzap command: npx args: ["-y", "flowzap-mcp"]
Sourcegraph Cody	通过 openctx.providers 配置添加到 VS Code 的 settings.json。

不兼容： 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 路径。

可用工具

核心工具

工具	描述
flowzap_validate	验证 FlowZap Code 语法
flowzap_fix	确定性地修复机械性 FlowZap Code 错误（编号、推断句柄、标签语法、缺失的泳道标签、表情符号/控制字符），并返回修复后的代码及所应用的更正
flowzap_create_playground	创建可分享的图表 URL
flowzap_get_syntax	获取 FlowZap Code 语法文档

面向 Agent 的工具

工具	描述
flowzap_export_graph	将 FlowZap Code 导出为结构化 JSON 图（泳道、节点、边），用于推理
flowzap_artifact_to_diagram	将 HTTP 日志、OpenAPI 规范或代码解析为 FlowZap 图表
flowzap_diff	比较两个版本的 FlowZap Code，并获取结构化差异
flowzap_apply_change	应用结构化补丁操作（插入/移除/更新节点/边）

合规工具

工具	描述
flowzap_compliance_check	对 FlowZap Code 数据流图运行自动化 SOC2、GDPR 和 PIPL 合规分析。由 Deepseek 大模型支持，且有严格的速率限制（每个 IP 每天 3 次、突发情况下每小时 1 次、全局 5 分钟熔断）。返回可分享的临时结果 URL（有效期 60 分钟）。

思维导图工具

工具	描述
flowzap_mindmap_validate	验证 FlowZap Code 语法及思维导图就绪状态
flowzap_mindmap_approve	检查代码是否适合渲染为思维导图（菱形/任务框 = 错误）
flowzap_mindmap_template	生成可直接扩展的思维导图树形骨架
flowzap_mindmap_create_playground	创建带有 ?view=mindmap 的 Playground URL

使用示例

创建基本图表

向你的 AI 助手提问：

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

面向 Agent 的工作流

将 HTTP 日志解析为图表：

"Here are my nginx access logs. Create a sequence diagram showing the request flow."

Agent 使用 flowzap_artifact_to_diagram，并设置 artifactType: "http_logs"。

分析图表结构：

"Which steps in this workflow touch the database?"

Agent 使用 flowzap_export_graph 获取 JSON 图，然后查询该图。

查看变更内容：

"I updated the workflow. What's different from the previous version?"

Agent 使用 flowzap_diff 比较新旧代码。

安全地进行增量更新：

"Add a logging step after the API call in this diagram."

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

修复无效代码：

"My FlowZap Code fails validation. Fix the mechanical errors for me."

Agent 使用 flowzap_fix 确定性地修复编号、推断出的句柄、标签语法、泳道标签、表情符号和控制字符，然后验证修复后的代码。修复器无法修复的内容会原样报告，不会凭空编造内容。

合规审计：

"Check my data flow diagram for SOC2, GDPR, and PIPL compliance."

Agent 使用 flowzap_compliance_check 运行自动化审计，并返回可分享的结果页面。

创建思维导图：

"Create a mind map about AI agent architecture"

Agent 使用 flowzap_mindmap_template 生成骨架，然后进行验证并创建带有 ?view=mindmap 的 Playground。

助手将：

1. 根据你的描述生成 FlowZap Code
2. 验证代码
3. 创建带有相应视图（工作流、序列或架构）的 Playground URL，以便查看和分享

FlowZap Code 示例

sales { # Sales Team
  n1: circle label:"Order Received"
  n2: rectangle label:"Submit Order"
  n5: rectangle label:"Receive decision"
  n1.handle(right) -> n2.handle(left)
  n2.handle(bottom) -> fulfillment.n3.handle(top) [label="Submit"]
}

fulfillment { # Fulfillment
  n3: rectangle label:"Review Order"
  n4: rectangle label:"Return decision"
  n3.handle(right) -> n4.handle(left)
  n4.handle(top) -> sales.n5.handle(bottom) [label="Approved"]
}

公共 API 端点

这些端点可用于外部集成（无需身份验证）：

端点	方法	速率限制	描述
/api/validate	POST	30/min	验证 FlowZap Code 语法
/api/fix	POST	30/min	确定性地修复 FlowZap Code 中的机械性错误，并返回修复后的代码及已应用的更正
/api/playground/create	POST	5/min, 50/day	创建临时 Playground URL（有效期 15 分钟）
/api/compliance-check	POST	5/min, 30/day	对 FlowZap Code 运行 SOC2/GDPR/PIPL 合规分析。返回框架及可分享的结果 URL（有效期 60 分钟）。由 Deepseek 大模型支持。

安全性

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

Agent 技能（skills.sh）

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

npx skills add flowzap-xyz/flowzap-mcp

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

MCP 公开采用情况信号

• MCP 公开使用统计： https://flowzap.xyz/.well-known/flowzap-stats.json
• MCP 调用徽章 JSON： https://flowzap.xyz/.well-known/flowzap-stats-badge.json

官方列表

• 官方 MCP 注册表： https://registry.modelcontextprotocol.io/?q=flowzap
• Smithery 服务： https://smithery.ai/server/@flowzap/flowzap
• Smithery 技能： https://smithery.ai/skills/Flowzap/diagram-skill
• PulseMCP： https://www.pulsemcp.com/servers/flowzap
• Glama： https://glama.ai/mcp/servers/flowzap-xyz/flowzap-mcp
• MCPServers.org： https://mcpservers.org/servers/flowzap-xyz-docs-mcp
• AIBase： https://mcp.aibase.com/server/1639702939289526535

链接

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

许可证

MIT