📚 Documentation MCP Server

Ein Model Context Protocol (MCP) Server zum Generieren professioneller Dokumentationen mit Unterstützung für mehrere Frameworks.

✨ Features

• 🔍 Deep Code Analysis - AST-basierte Multi-Language Analysis
  • TypeScript/JavaScript: TypeScript Compiler API
  • Python: Native Python AST module
  • Go: Go parser & AST
  • PHP: Regex-basierte Analyse + PHP 8+ Features
  • Extrahiert Klassen, Funktionen, Interfaces, Methoden, Properties
  • PHP 8+: Enums, Traits, Attributes
  • Erfasst JSDoc/Docstrings/Go Doc/PHPDoc und berechnet Dokumentations-Coverage
  • Analysiert Imports/Exports und Module-Dependencies
• 🌍 Multi-Language Projects - Automatische Erkennung und parallele Analyse mehrerer Sprachen
• 📊 Projekt-Analyse - Automatische Code-Analyse für TypeScript, JavaScript, Python, Go, PHP
• 🏗️ Struktur-Generierung - Erstellt komplette Dokumentations-Gerüste
• ✍️ Seiten-Editor - Erstellt und bearbeitet einzelne Dokumentationsseiten
• 📖 API-Dokumentation - Generiert API-Docs aus Code-Kommentaren
• 🌐 Static Site Builder - Baut statische Websites für Hosting
• 📄 PDF-Export - Konvertiert Dokumentation zu PDF
• 👀 Live-Preview - Lokaler Entwicklungsserver

🛠️ Unterstützte Frameworks

• Docusaurus (React-basiert, modern, verschiedene Templates)
• MkDocs (Python-basiert, Markdown-fokussiert, einfach)
• Sphinx (Python, sehr mächtig, für komplexe Projekte)

🚀 Quick Start

1. Verzeichnisse erstellen:

   mkdir src
   mkdir src\tools

2. Dependencies installieren:

   npm install

3. Build:

   npm run build

4. MCP Server in Claude Desktop konfigurieren (siehe SETUP.md)

📦 Tools

docs_analyze_project

Analysiert Projekt-Struktur und führt Deep Code Analysis durch.

Parameter:

• projectPath (string, required) - Pfad zum Projekt
• language (enum, optional) - Programmiersprache (typescript, javascript, python, go, rust, java, csharp)
• deep (boolean, optional, default: true) - Aktiviert Deep Code Analysis

Deep Analysis Features:

• 📦 Extrahiert Classes/Structs, Interfaces, Functions, Enums, Type Aliases
• 🔍 Erfasst Methods, Properties, Constructors mit vollständigen Details
• 📝 Analysiert JSDoc/Docstrings/Go Doc und berechnet Documentation Coverage
• 🔗 Trackt Imports/Exports und Module Dependencies
• 📊 Generiert Zusammenfassungs-Statistiken
• 🎯 Multi-Language Support:
  • ✅ TypeScript/JavaScript (TypeScript Compiler API)
  • ✅ Python (Native Python AST)
  • ✅ Go (go/parser & go/ast)
  • ✅ PHP v2 (nikic/php-parser AST) - Neu! 100% genau
    • Namespaces & Use-Statements
    • Union/Intersection/Nullable Types
    • Enums, Traits, Attributes (PHP 8+)
    • Framework Detection:
      • CodeIgniter 3/4 (Controller, Model)
      • Laravel (Illuminate*)
      • Symfony (Symfony*)
      • MVC Pattern Recognition
    • Route Detection: 🚀
      • Convention-based: /controller/method/{param}
      • Attribute-based: #[Get('/')], #[Post('/')]
      • HTTP Methods: GET, POST, PUT, PATCH, DELETE
      • Parameter Types & Required/Optional Status
    • Middleware Detection: 🔒
      • Laravel: #[Middleware('auth')]
      • Symfony: #[IsGranted('ROLE_ADMIN')]
      • CodeIgniter 4: #[Filter('auth')]
      • CodeIgniter 3: @middleware (Docblocks)
      • Class-Level & Method-Level
      • Middleware Parameters
    • OpenAPI 3.0 Export: 📋
      • Auto-generates Swagger/OpenAPI specs
      • Routes → Paths conversion
      • Middleware → Security Schemes
      • JSON & YAML format support
  • ✅ PHP v1 (Regex-based) - Fallback
  • 🌍 Automatische Multi-Language-Erkennung
  • 🔜 Rust, Java, C# (in Planung)

Beispiel-Rückgabe:

{
  "deepAnalysis": {
    "summary": {
      "totalFiles": 11,
      "totalClasses": 2,
      "totalInterfaces": 23,
      "totalFunctions": 16,
      "overallDocCoverage": 3.17
    }
  }
}

docs_generate_structure

Generiert Dokumentations-Gerüst.

Parameter:

• projectPath (string, required) - Pfad zum Projekt
• framework (enum, required) - docusaurus | mkdocs | sphinx
• template (string, optional) - Template-Name
• outputPath (string, optional) - Ausgabepfad (default: ./docs)

docs_create_page

Erstellt oder bearbeitet Dokumentationsseite.

Parameter:

• docsPath (string, required) - Pfad zur Doku
• pagePath (string, required) - Relativer Pfad zur Seite
• title (string, required) - Seitentitel
• content (string, required) - Markdown-Inhalt

docs_generate_api

Generiert API-Dokumentation aus Code.

Parameter:

• projectPath (string, required) - Pfad zum Quellcode
• outputPath (string, required) - Ausgabepfad
• language (enum, required) - Programmiersprache

docs_build_static

Baut statische Website.

Parameter:

• docsPath (string, required) - Pfad zur Doku
• framework (enum, required) - Framework
• outputPath (string, optional) - Ausgabepfad (default: ./build)

docs_export_pdf

Exportiert Dokumentation als PDF.

Parameter:

• docsPath (string, required) - Pfad zur Doku
• outputPath (string, required) - PDF-Ausgabepfad
• includePages (array, optional) - Spezifische Seiten

docs_preview

Startet lokalen Dev-Server.

Parameter:

• docsPath (string, required) - Pfad zur Doku
• framework (enum, required) - Framework
• port (number, optional) - Port (default: 3000/8000)

docs_generate_openapi

Generiert OpenAPI 3.0 Spezifikation aus PHP-Code.

Parameter:

• projectPath (string, required) - PHP-Projekt Pfad
• outputPath (string, optional) - Ausgabepfad (default: ./openapi.json)
• format (enum, optional) - json | yaml (default: json)
• title (string, optional) - API-Titel
• version (string, optional) - API-Version
• serverUrl (string, optional) - API Server URL

docs_generate_sales_docs 🎯 NEU!

Generiert professionelle, verkaufsfertige Dokumentation für CodeCanyon, ThemeForest, etc.

Parameter:

• projectPath (string, required) - PHP-Projekt Pfad
• outputDir (string, optional) - Ausgabe-Verzeichnis (default: ./sales-docs)
• productName (string, required) - Produktname
• productVersion (string, optional) - Version (default: 1.0.0)
• author (string, required) - Autor/Firma
• description (string, required) - Produktbeschreibung
• price (string, optional) - Preis (z.B., "$49")
• demoUrl (string, optional) - Live-Demo URL
• supportEmail (string, optional) - Support E-Mail
• features (array, optional) - Liste der Key Features

Generierte Dateien:

1. README.md (2.5 KB) - Produkt-Übersicht mit Features, Statistiken, Requirements
2. INSTALLATION.md (3.2 KB) - Schritt-für-Schritt Setup-Guide
3. API_REFERENCE.md (24.2 KB) - Komplette API-Dokumentation
4. CONFIGURATION.md (2.1 KB) - Umgebungsvariablen, Security
5. EXAMPLES.md (4.0 KB) - Code-Beispiele (JS, PHP, Python)
6. FAQ.md (2.2 KB) - Häufig gestellte Fragen
7. CHANGELOG.md (0.9 KB) - Versionshistorie
8. COMPLETE_DOCUMENTATION.md (39.0 KB) - All-in-One für PDF

Gesamt: ~78 KB professionelle Dokumentation!

🏗️ Architektur

src/
├── index.ts                    # MCP Server Hauptdatei
├── core/                       # Kern-Module für Deep Analysis
│   ├── types.ts               # Type-Definitionen für alle Sprachen
│   └── analyzer.ts            # Abstract Base Class & Factory
├── analyzers/                  # Sprachspezifische Analyzer
│   ├── typescript.ts          # TypeScript/JavaScript (TS Compiler API)
│   ├── python.ts              # Python Wrapper (subprocess)
│   ├── go.ts                  # Go Wrapper (subprocess)
│   └── helpers/               # Native Language Parsers
│       ├── python_analyzer.py # Python AST Parser
│       └── go_analyzer.go     # Go AST Parser
└── tools/                      # MCP Tool-Implementierungen
    ├── analyzeProject.ts      # Deep Analysis Integration
    ├── generateStructure.ts
    ├── createPage.ts
    ├── generateApi.ts
    ├── buildStatic.ts
    ├── exportPdf.ts
    └── preview.ts

🔬 Deep Analysis Pipeline

1. File Scanning - Durchsucht Projekt-Verzeichnis
2. Language Detection - Erkennt dominante Programmiersprache
3. Analyzer Selection - Wählt passenden AST-Parser (Factory Pattern)
4. AST Parsing - Parst Code-Dateien mit sprachspezifischem Parser
   • TypeScript: TS Compiler API (in-process)
   • Python: Python AST module (subprocess)
   • Go: go/parser & go/ast (subprocess)
5. Symbol Extraction - Extrahiert alle Code-Symbole (Classes, Functions, etc.)
6. Documentation Analysis - Erfasst Dokumentations-Kommentare
7. Summary Generation - Berechnet Statistiken und Coverage

📝 Lizenz

MIT