Statik analiz kullanarak herhangi bir kod tabanından görsel mimari diyagramları ve eşzamanlılık darboğazı tahminleri oluşturur.
Ayrıca bilinen adı askuma/workflow-generator, workflow-generator, workflow-generator-mcp
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- 365
- En son sürüm
- 0.5.0
- Son commit
- 26 Eki 2026
- Lisans
- MIT
Workflow Generator MCP nedir?
Statik analiz kullanarak herhangi bir kod tabanından görsel mimari diyagramları ve eşzamanlılık darboğazı tahminleri oluşturur.
Özet, projenin README dosyasından oluşturuldu
Workflow Generator MCP sunucusu hakkında
Workflow Generator, geliştiricilerin bir kod tabanından sistem mimarisini görselleştirmesini ve performans darboğazlarını belirlemesini sağlar. Python, Node.js, Go, Java, Rust veya Ruby ile yazılmış projeler üzerinde statik analiz gerçekleştirerek kapsamlı bir WORKFLOW.html raporu üretir. Bu rapor; karanlık mod destekli görsel bir diyagram, bağımlılık grafiği ve eşzamanlılık sınırları ile pratik işleme kapasitesi (throughput) tahminlerini içerir.
Kullanıcılar bunu bağımsız bir CLI aracı olarak çalıştırabilir veya Claude Desktop, Cursor, VS Code veya Zed gibi MCP uyumlu istemcilere bağlayabilir. Sunucu iki temel araç sağlar: tam HTML raporunu oluşturmak için generate_workflow ve yapılandırılmış bir JSON özeti almak için analyze_workflow. Doğruluğu sağlamak için node_modules veya venv gibi dahil edilen dizinleri otomatik olarak görmezden gelir. Daha derin içgörüler için, gerçek istek sayılarını bağımlılık grafiğine bindirmek üzere bir erişim günlüğü sağlayabilirsiniz; ayrıca araç, statik analiz tahminlerini gerçek dünya ölçümleriyle doğrulamak için bir k6 yük testi betiği bile oluşturur.
Neler yapabilirsiniz
- 1Görsel sistem diyagramları oluşturunProjenizdeki tüm bileşenlerin nasıl etkileşime girdiğine dair görsel bir temsil oluşturması için yapay zekadan talepte bulunun.
- 2Eşzamanlılık sınırlarını tahmin edinMevcut mimarinizin işleyebileceği maksimum eşzamanlı istek sayısını belirleyin.
- 3Performans darboğazlarını tespit edinYığın katmanlarınızda sistem işleme kapasitenizi sınırlayan belirli katmanları bulun.
- 4Kod tabanı bağımlılıklarını haritalandırınKaynak dosyalar ile veritabanları veya LLM sağlayıcıları gibi harici servisler arasındaki ilişkiyi görselleştirin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Workflow Generator MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleWorkflow Generator MCP'yi Claude Code içine yükleyin
$ claude mcp add workflow-generator -- uvx workflow-generator-mcpWorkflow Generator MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"workflow-generator": {
"command": "uvx",
"args": [
"workflow-generator-mcp"
]
}
}
}Workflow Generator MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"workflow-generator": {
"type": "stdio",
"command": "uvx",
"args": [
"workflow-generator-mcp"
]
}
}
}Workflow Generator MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"workflow-generator","type":"stdio","command":"uvx","args":["workflow-generator-mcp"]}'Workflow Generator MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"workflow-generator": {
"command": "uvx",
"args": [
"workflow-generator-mcp"
]
}
}
}Workflow Generator MCP'yi Codex içine yükleyin
$ codex mcp add workflow-generator -- uvx workflow-generator-mcpWorkflow Generator MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.workflow-generator] command = "uvx" args = ["workflow-generator-mcp"]
Workflow Generator MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user workflow-generator uvx -- workflow-generator-mcpWorkflow Generator MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"workflow-generator": {
"command": "uvx",
"args": [
"workflow-generator-mcp"
]
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebiliraskuma/workflow-generator is public and reachablegithub.com/askuma/workflow-generator ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorworkflow-generator-mcp names askuma/workflow-generator as sourcepypi.org/project/workflow-generator-mcp/ ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for workflow-generator-mcppypi.org/project/workflow-generator-mcp/ ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-26github.com/askuma/workflow-generator ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from workflow-generator-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok29 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
workflow-generator
Scan any project and generate WORKFLOW.html — a dark-mode visual system diagram showing every component, how they talk to each other, and where your throughput ceiling actually is.
Works with Python, Node.js, Go, Java, Rust, Ruby, and mixed projects. No external dependencies for the core scanner.
Vendored and generated directories (node_modules, venv, site-packages, dist, …) are never scanned,
and capacity figures are clearly labeled as static-analysis estimates.
Live demo → — generated from fastapi/full-stack-fastapi-template, unmodified.

(real CLI output, unscripted — static screenshot if you'd rather not autoplay)
What it produces
Every generated page contains:
| Section | What you get |
|---|---|
| Stat row | Workers · Concurrent I/O ceiling · Semaphore limit · Rate limit · Practical throughput |
| Architecture diagram | Layered flow: external sources → gateway → API → queues → AI → storage |
| Data flow cards | Write path, read/query path, background jobs — inferred from what's detected |
| Concurrency table | Every layer: model · ceiling · limiting factor |
| Bottleneck analysis | Ranked CRITICAL → LOW with mitigation notes |
| Codebase dependency graph | Force-directed module/import graph — click a node to isolate its neighbors, hover for file details. Import-direction edges are clearly distinguished from real observed traffic (see below) |
| Guided tour | Spotlight walkthrough of every section, shown automatically the first time a report is opened; replay anytime with the ? button |
Codebase dependency graph
Every source file (Python, JS/TS, Go, Java, Rust, Ruby) becomes a node; every real import becomes
an edge — resolved with a language-appropriate parser (Python's ast module, regex for JS/TS/Go/
Java/Rust/Ruby), not guessed. Files that match an already-detected component (an LLM call, a
database client, a queue) get an edge to that component too, so you can see exactly which files
talk to Redis, OpenAI, etc. Large repos (350+ files) are automatically aggregated into
directory-level nodes so the graph stays readable; override with --graph-detail files or
--graph-detail dirs.
Test files (tests/, test_*.py, conftest.py, *.spec.ts, *_test.go, …) get their own
Test Graph section below the main one, showing which modules and services each test reaches.
Fixtures and test doubles name every service they exercise, so keeping them in the main graph
buries the real dependency structure under service edges.
Both sections have a Flow | Graph toggle over the same nodes and edges. Flow (the default up to 80 nodes) is a left-to-right layered diagram: columns are dependency depth from the sources (HTTP entry and files nothing imports), every detected service is its own node in the last column, and import cycles are drawn dashed. Graph is the force-directed view. Moving dots show data going both ways: a filled dot is the call/request, a hollow dot the return/response. On graphs with more than 60 edges, only the paths of the clicked or hovered node animate. Search, "hide isolated" and the selected node are shared between the two views.
The older layered Full System Architecture diagram is collapsed by default, since the Architecture Map covers the same ground.
By default the graph only shows what the code says (import direction, static "this file calls
Redis"), which is honest but not the same as real traffic. Pass --access-log /path/to/access.log
(any combined/common log format) to overlay real observed request counts onto the HTTP-entry
edges — and the generated report includes a ready-to-run k6 load-test script
covering up to 5 detected routes, so the "Practical throughput" number can be checked against a
real measurement instead of only a static-analysis estimate.
What it detects
| Category | Examples |
|---|---|
| API frameworks | FastAPI, Flask, Django, Express, Nest.js, Gin |
| Gateways | nginx, Caddy, Traefik (with rate limits + worker_connections) |
| LLM providers | OpenAI, Anthropic Claude, Cohere, AWS Bedrock |
| Vector stores | Qdrant, Pinecone, Weaviate, ChromaDB, pgvector, FAISS, Milvus |
| Databases | PostgreSQL, MySQL, MongoDB, SQLite, Redis |
| Queues | Celery, BullMQ, Kafka, RabbitMQ, RQ, AWS SQS |
| Async primitives | asyncio.Semaphore, run_in_executor, asyncio.gather, asyncio.Lock |
| Workers | --workers N (uvicorn/gunicorn), replicas: (docker-compose), PM2 instances |
| External sources | Jira, Azure DevOps, Slack, GitHub, Stripe, Salesforce, Twilio |
| Evaluation | TruLens, RAGAS, LangSmith |
Install
pip (CLI + MCP server)
pip install workflow-generator-mcp
workflow-generator . WORKFLOW.html # CLI: scan and write the report
workflow-generator-mcp # stdio MCP server
With pip installed, any MCP host config reduces to:
{
"mcpServers": {
"workflow-generator": { "command": "workflow-generator-mcp" }
}
}
Claude Code (skill)
mkdir -p ~/.claude/skills
git clone https://github.com/askuma/workflow-generator.git ~/.claude/skills/workflow-generator
Then in any Claude Code session:
/workflow-generator
/workflow-generator /path/to/project
MCP server (Claude Desktop, VS Code, Cursor, Zed, Windsurf, Continue)
1. Install the dependency:
pip install mcp
2. Add to your MCP host config (replace ~ with your actual home path):
~/Library/Application Support/Claude/claude_desktop_config.json (Mac)
%APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"workflow-generator": {
"command": "python3",
"args": ["~/.claude/skills/workflow-generator/mcp/server.py"]
}
}
}
.vscode/mcp.json
{
"servers": {
"workflow-generator": {
"type": "stdio",
"command": "python3",
"args": ["~/.claude/skills/workflow-generator/mcp/server.py"]
}
}
}
~/.cursor/mcp.json
{
"mcpServers": {
"workflow-generator": {
"command": "python3",
"args": ["~/.claude/skills/workflow-generator/mcp/server.py"]
}
}
}
.zed/settings.json
{
"context_servers": {
"workflow-generator": {
"command": {
"path": "python3",
"args": ["~/.claude/skills/workflow-generator/mcp/server.py"]
}
}
}
}
~/.windsurf/mcp_config.json
{
"mcpServers": {
"workflow-generator": {
"command": "python3",
"args": ["~/.claude/skills/workflow-generator/mcp/server.py"]
}
}
}
3. Restart your tool, then ask:
generate a workflow diagram for this project
how many concurrent requests can this handle?
show me the system architecture
MCP tools exposed:
generate_workflow— scans project, writesWORKFLOW.html, optionally opens in browseranalyze_workflow— returns structured JSON summary (no file written)
Command line (standalone)
No install needed beyond Python 3.8+:
python3 ~/.claude/skills/workflow-generator/scripts/analyze.py . ~/WORKFLOW.html
# then open ~/WORKFLOW.html
Optional flags:
--access-log /path/to/access.log # overlay real request counts onto the dependency graph
--graph-detail auto|files|dirs # force file-level or directory-level graph nodes (default: auto)
Example output (terminal)
Written: /your/project/WORKFLOW.html
Framework: FastAPI · Workers: 8 · Concurrent I/O: ~800
Practical throughput: ~50–200 req/min
Bottleneck: OpenAI (LLM latency 3–30s per call)
Gateway: nginx · 2 rate limit zone(s)
LLM: OpenAI · eval: TruLens RAG Triad
Storage: Qdrant, Redis
External sources: Jira, Azure DevOps, Slack
Repo layout
workflow-generator/
├── SKILL.md ← Claude Code skill definition
├── INSTALL.md ← detailed per-platform install guide
├── workflow_generator_mcp/
│ ├── analyze.py ← core scanner + HTML renderer (stdlib only)
│ └── server.py ← MCP stdio server (package form)
├── scripts/
│ └── analyze.py ← thin compatibility shim -> workflow_generator_mcp/analyze.py
├── tests/ ← pytest suite for the scanner
├── mcp/
│ ├── server.py ← MCP stdio server
│ └── requirements.txt ← pip install mcp
└── copilot/
├── index.js ← GitHub Copilot Extension (Express)
├── package.json
└── openai_function.json
License
MIT
Workflow Generator MCP soruları
Workflow Generator MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add workflow-generator -- uvx workflow-generator-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Workflow Generator MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Hangi programlama dilleri destekleniyor?
Tarayıcı; Python, Node.js, Go, Java, Rust, Ruby ve karma projelerle çalışır.
node_modules veya sanal ortamları tarıyor mu?
Hayır, node_modules, venv ve site-packages gibi dahil edilen (vendored) ve oluşturulan dizinler tarama dışında tutulur.
Kapasite rakamları ne kadar doğru?
Kapasite rakamları, statik analize dayalı tahminler olarak sunulur.
Grafik üzerine gerçek trafik verilerini bindirebilir miyim?
Evet, HTTP giriş kenarlarına gerçek gözlemlenen istek sayılarını bindirmek için bir erişim günlüğü (access log) yolu iletebilirsiniz.