{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FlowZap MCP 服务器文档","version":"1.4.3","lastUpdated":"2026-05-25","language":"zh","targetAudience":["大语言模型","AI 代理","Agent 系统"],"urls":{"capabilitiesManifest":"https://flowzap.xyz/zh/.well-known/capabilities.json","documentation":"https://flowzap.xyz/zh/docs/mcp","markdown":"https://flowzap.xyz/zh/docs/mcp.md","json":"https://flowzap.xyz/zh/docs/mcp.json","syntaxSpec":"https://flowzap.xyz/zh/flowzap-code","playground":"https://flowzap.xyz/zh/playground","templates":"https://flowzap.xyz/zh/templates","npmPackage":"https://www.npmjs.com/package/flowzap-mcp","agentSkill":"https://skills.sh/flowzap-xyz/flowzap-mcp/flowzap-diagrams","skillSource":"https://github.com/flowzap-xyz/flowzap-mcp/tree/main/skills/flowzap-diagrams","usageStats":"https://flowzap.xyz/.well-known/flowzap-stats.json"},"overview":{"description":"FlowZap MCP 服务器让 AI 代理能够使用 FlowZap Code 创建、校验并分享工作流图、时序图和架构图。","keyFeatures":["AI-first 生成 - 语法针对 LLM 输出做了优化","面向代理的工作流 - 适用于 n8n、Make.com 与 Zapier","三视图渲染 - 同一份代码可渲染为 workflow、sequence 和 architecture","即时分享 - 无需认证即可生成可分享 URL"]},"installation":{"compatibleTools":[{"name":"Claude Desktop","howToConfigure":"将配置添加到 claude_desktop_config.json"},{"name":"Claude Code","howToConfigure":"运行 CLI 命令或将配置添加到项目根目录的 .mcp.json"},{"name":"Cursor","howToConfigure":"打开 Settings → Features → MCP Servers → Add Server，然后粘贴 JSON 配置"},{"name":"Windsurf IDE","howToConfigure":"将配置添加到 ~/.codeium/windsurf/mcp_config.json"},{"name":"OpenAI Codex","howToConfigure":"将配置写入 ~/.codex/config.toml 或使用 CLI 命令"},{"name":"Warp Terminal","howToConfigure":"Settings → MCP Servers → + Add → 粘贴 JSON 配置"},{"name":"Zed Editor","howToConfigure":"在 settings.json 的 context_servers 中添加配置"},{"name":"Cline (VS Code)","howToConfigure":"打开 Cline 侧边栏并编辑 cline_mcp_settings.json"},{"name":"Roo Code (VS Code)","howToConfigure":"将配置添加到 .roo/mcp.json"},{"name":"Continue.dev","howToConfigure":"创建 .continue/mcpServers/flowzap.yaml"},{"name":"Sourcegraph Cody","howToConfigure":"通过 openctx.providers 配置写入 settings.json"}],"notCompatible":[{"name":"Replit","reason":"仅支持通过 URL 连接远程 MCP 服务器（不支持 STDIO）","alternative":"请使用 POST https://flowzap.xyz/api/playground/create"},{"name":"Lovable.dev","reason":"仅支持通过 URL 连接远程 MCP 服务器（不支持 STDIO）","alternative":"请使用 POST https://flowzap.xyz/api/playground/create"}],"jsonConfig":{"mcpServers":{"flowzap":{"command":"npx","args":["-y","flowzap-mcp"]}}},"windowsNote":"如果工具没有显示，请使用绝对路径 C:\\Program Files\\nodejs\\npx.cmd。可通过 where.exe npx 查找。"},"tools":[{"name":"flowzap_get_syntax","purpose":"获取完整的 FlowZap Code 语法文档","whenToUse":"在生成 FlowZap Code 之前调用，确保代理遵守 DSL 规则。","inputSchema":{"type":"object","properties":{},"required":[]},"output":"完整语法指南，包含约束、形状、节点、边、循环以及常见错误。"},{"name":"flowzap_validate","purpose":"在创建图表前校验 FlowZap Code 语法","whenToUse":"调用 flowzap_create_playground 之前务必先校验。","inputSchema":{"type":"object","properties":{"code":{"type":"string","description":"待校验的 FlowZap Code"}},"required":["code"]},"output":{"success":"返回 lanes、节点、边和循环等校验统计信息","failure":"逐行错误消息及修复建议"}},{"name":"flowzap_create_playground","purpose":"创建包含图表的可分享 playground URL","whenToUse":"校验通过后，为用户生成可打开和编辑的交互式链接。","inputSchema":{"type":"object","properties":{"code":{"type":"string","description":"要加载到 playground 中的 FlowZap Code"},"view":{"type":"string","enum":["workflow","sequence","architecture"],"description":"初始视图模式"}},"required":["code"]},"output":"包含过期时间的可分享 playground URL"},{"name":"flowzap_export_graph","purpose":"将 FlowZap Code 导出为结构化 JSON 图","whenToUse":"当代理需要 lanes、节点和边的结构化数据进行推理时使用。","inputSchema":{"type":"object","properties":{"code":{"type":"string","description":"要解析的 FlowZap Code"}},"required":["code"]},"output":"包含 lanes、节点和边的 JSON 图结构"},{"name":"flowzap_artifact_to_diagram","purpose":"将 HTTP 日志、OpenAPI 规范或代码转换为 FlowZap 图表","whenToUse":"当代理需要把技术制品转换为图表时使用。","inputSchema":{"type":"object","properties":{"artifactType":{"type":"string","enum":["http_logs","openapi","code"]},"content":{"type":"string","description":"原始制品内容"},"view":{"type":"string","enum":["workflow","sequence","architecture"]}},"required":["artifactType","content"]},"output":"FlowZap Code 与 playground URL"},{"name":"flowzap_diff","purpose":"比较两份 FlowZap Code","whenToUse":"用于解释、审查或展示图表变更。","inputSchema":{"type":"object","properties":{"oldCode":{"type":"string","description":"原始 FlowZap Code"},"newCode":{"type":"string","description":"更新后的 FlowZap Code"}},"required":["oldCode","newCode"]},"output":"展示新增、删除和更新内容的结构化 diff"},{"name":"flowzap_apply_change","purpose":"对 FlowZap Code 应用结构化补丁操作","whenToUse":"适用于对现有图表进行增量编辑。","inputSchema":{"type":"object","properties":{"code":{"type":"string","description":"当前 FlowZap Code"},"operations":{"type":"array","items":{"type":"object","properties":{"op":{"type":"string","enum":["insertNode","removeNode","updateNode","insertEdge","removeEdge"]}}}}},"required":["code","operations"]},"output":"更新后的 FlowZap Code 与 playground URL"}],"security":{"networkSecurity":{"ssrfPrevention":"仅允许通过 HTTPS 连接 flowzap.xyz 和 www.flowzap.xyz","urlValidation":"所有返回的 URL 都会验证其确实属于 FlowZap 域名","requestTimeout":"30 秒"},"inputValidation":{"maxCodeLength":50000,"maxInputLength":100000,"nullByteRemoval":true,"controlCharacterSanitization":true},"rateLimiting":{"validate":{"maxRequests":30,"windowSeconds":60},"playground":{"maxRequests":5,"windowSeconds":60,"dailyLimit":50}},"dataPrivacy":{"authenticationRequired":false,"userDataStored":false,"sessionTTL":"60 分钟","tracking":false,"cookies":false}},"syntax":{"globalConstraints":["仅允许 UTF-8 纯文本（不含 emoji）","节点 ID 必须为 n1、n2、n3...（全局唯一、连续编号）","只允许 4 种形状：circle、rectangle、diamond、taskbox","只允许 4 个属性：label、owner、description、system","lane 注释必须和 laneName { # Label 保持在同一行","不要混用 Mermaid、PlantUML 或其他 DSL 语法","为保证时序图质量，边应按时间顺序定义","不要有孤立节点：每个节点都必须至少参与一条边"],"shapes":{"circle":"开始/结束事件","rectangle":"任务、活动、流程步骤","diamond":"决策网关","taskbox":"带 owner、description 和 system 的任务框"},"nodeAttributeSyntax":"使用冒号 (label:\"Text\")","edgeLabelSyntax":"使用方括号加等号 ([label=\"Text\"])","handleDirections":["left","right","top","bottom"],"crossLaneEdgeFormat":"laneName.nX.handle(direction)","loopFormat":"loop [condition] n1 n2 n3"},"discoveryLinks":{"humanDocs":"https://flowzap.xyz/zh/docs/mcp","machineDocs":"https://flowzap.xyz/zh/docs/mcp.json","markdown":"https://flowzap.xyz/zh/docs/mcp.md","llmsFullTxt":"https://flowzap.xyz/zh/llms-full.txt","capabilitiesManifest":"https://flowzap.xyz/zh/.well-known/capabilities.json","usageStats":"https://flowzap.xyz/.well-known/flowzap-stats.json","officialRegistry":"https://registry.modelcontextprotocol.io/?q=flowzap","smitheryServer":"https://smithery.ai/server/@flowzap/flowzap","pulseMcp":"https://www.pulsemcp.com/servers/flowzap","glama":"https://glama.ai/mcp/servers/flowzap-xyz/flowzap-mcp","mcpServersOrg":"https://mcpservers.org/servers/flowzap-xyz-docs-mcp","aiBase":"https://mcp.aibase.com/server/1639702939289526535"}}