MCP Code Flow Analyzer

An MCP (Model Context Protocol) server for analyzing and tracing business code flows across your codebase. Helps developers quickly understand the complete execution path of features from frontend to backend to database.

Features

• Business Flow Tracing: Follow function calls from entry points through the entire codebase
• Multi-Language Support: TypeScript, JavaScript
• Smart Symbol Extraction: Automatically identifies functions, classes, variables, and imports
• Call Graph Analysis: Builds and traverses function call relationships
• Clickable Links: Generate VSCode and GitHub links for quick navigation
• Flexible Configuration: YAML-based project configuration

Installation

npm install
npm run build

Usage

1. Configure Your Project

Create a .flowanalysis.yaml file:

version: '1.0'
project:
  name: "my-project"
  languages: [typescript]
  rootPath: "."
sourceConfig:
  include: ["src/**/*.ts"]
  exclude: ["**/*.test.ts", "node_modules/**"]
analysisConfig:
  maxCallDepth: 10
  crossFileAnalysis: true
linkConfig:
  vscode: { enabled: true }
  github:
    enabled: true
    repository: "https://github.com/owner/repo"

2. Configure in VSCode

{
  "modelContextProtocol": {
    "servers": {
      "code-flow-analyzer": {
        "command": "node",
        "args": ["/path/to/mcp-server/dist/index.js"],
        "env": { "PROJECT_ROOT": "${workspaceFolder}" }
      }
    }
  }
}

MCP Tools

• traceBusinessFlow — Trace the complete execution path from an entry point
• findCallers — Find all functions that call a given function
• getProjectInfo — Get metadata about the project and analysis results
• generateFlowDiagram — Generate a Mermaid call graph diagram

Architecture

MCP Server (index.ts)
├── Project Config Manager
├── Code Analysis Manager
│   ├── Parser Factory
│   │   ├── TypeScript Parser
│   └── Symbol Table
├── Call Graph Analyzer
└── Link Generators
    ├── VSCode Link Generator
    └── GitHub Link Generator

Development

npm run build      # Build
npm run typecheck  # Type check
npm run start      # Run server
npm run dev        # Build + run

License

MIT