Flowzap

FlowZap MCP Server

Claude、Cursor、Windsurf、およびそのほか8つのMCP対応ツールなどのAIアシスタントを使って、ワークフロー、シーケンス、アーキテクチャ、マインドマップの図を作成できます。

FlowZap は、FlowZap Code というテキストベースのDSLを使う、ビジュアルなワークフロー図作成ツールです。このMCPサーバーを使うと、AIアシスタントに図を作成させることができます。

FlowZapとは？

FlowZapは、FlowZap Code DSLを使って、テキストプロンプトを4種類のビュー（ワークフロー、シーケンス、アーキテクチャ、マインドマップ）の図に変換します。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の構文ドキュメントを取得します

エージェント向けツール

ツール	説明
flowzap_export_graph	FlowZap Code を構造化 JSON グラフ（レーン、ノード、エッジ）としてエクスポートし、推論に利用します
flowzap_artifact_to_diagram	HTTP ログ、OpenAPI 仕様、またはコードを解析して FlowZap 図に変換します
flowzap_diff	FlowZap Code の 2 つのバージョンを比較し、構造化された差分を取得します
flowzap_apply_change	構造化パッチ操作（ノード／エッジの挿入、削除、更新）を適用します

コンプライアンスツール

ツール	説明
flowzap_compliance_check	FlowZap Code のデータフロー図に対して、SOC2、GDPR、PIPL の自動コンプライアンス分析を実行します。Deepseek LLM を基盤としており、厳格なレート制限（IP あたり 1 日 3 回、バースト時は 1 時間あたり 1 回、グローバルのサーキットブレーカーは 5 分間）があります。共有可能な一時的な結果 URL（有効期間 60 分）を返します。

マインドマップツール

ツール	説明
flowzap_mindmap_validate	FlowZap Code の構文とマインドマップへの対応状況を検証します
flowzap_mindmap_approve	コードがマインドマップの描画に適しているか確認します（ひし形／タスクボックスはエラー）
flowzap_mindmap_template	すぐに拡張できるマインドマップのツリーの骨組みを生成します
flowzap_mindmap_create_playground	?view=mindmap を含むプレイグラウンド URL を作成します

使用例

基本的な図の作成

AI アシスタントに次のように依頼します。

• 「このアプリに実装されている現在のサインインフローのシーケンス図を生成して」
• 「注文処理システムのワークフロー図を作成して」
• 「マイクロサービス API ゲートウェイのアーキテクチャ図を作成して」
• 「ユーザー登録フローを示すフローチャートを作成して」
• 「ビルド、テスト、デプロイの各段階を含む CI/CD パイプラインを図にして」

エージェント向けワークフロー

HTTP ログを図に変換する：

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

エージェントは flowzap_artifact_to_diagram を artifactType: "http_logs" とともに使用します。

図の構造を分析する：

"Which steps in this workflow touch the database?"

エージェントは flowzap_export_graph を使用して JSON グラフを取得し、それに対してクエリを実行します。

変更内容を表示する：

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

エージェントは flowzap_diff を使用して変更前と変更後のコードを比較します。

安全な段階的更新：

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

エージェントは再生成する代わりに、構造化パッチを指定して flowzap_apply_change を使用します。

無効なコードを修復する：

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

エージェントは flowzap_fix を使用して、番号付け、推論されたハンドル、ラベル構文、レーンラベル、絵文字、制御文字を決定論的に修復し、その後、修復したコードを検証します。修復ツールで修正できない箇所はそのまま報告されます。内容を捏造することはありません。

コンプライアンス監査：

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

エージェントは flowzap_compliance_check を使用して自動監査を実行し、共有可能な結果ページを返します。

マインドマップの作成：

"Create a mind map about AI agent architecture"

エージェントは flowzap_mindmap_template を使用して骨組みを生成し、検証したうえで ?view=mindmap を指定したプレイグラウンドを作成します。

アシスタントは次の処理を行います。

1. 説明に基づいて FlowZap Code を生成します
2. コードを検証します
3. 表示および共有用に、適切なビュー（ワークフロー、シーケンス、アーキテクチャ）を指定したプレイグラウンド 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	一時的なプレイグラウンド URL（有効期間 15 分）を作成します
/api/compliance-check	POST	5/min, 30/day	FlowZap Code に対して SOC2／GDPR／PIPL のコンプライアンス分析を実行します。フレームワークと共有可能な結果 URL（有効期間 60 分）を返します。Deepseek LLM を基盤としています。

セキュリティ

• 認証不要 - 公開 FlowZap API のみを使用します
• ユーザーデータにアクセスしません - 図やアカウントを読み取ることはできません
• ローカルで実行 - MCP サーバーはお使いのマシン上で実行されます
• SSRF 対策済み - flowzap.xyz にのみ接続します
• レート制限あり - クライアント側で毎分 30 リクエストまで
• 入力検証 - コードサイズの上限は 50KB です

エージェントスキル（skills.sh）

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 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 ブログ
• LLM コンテキスト
• テンプレートライブラリ
• npm パッケージ
• GitHub リポジトリ

ライセンス

MIT