📚 Documentation MCP Server

A Model Context Protocol (MCP) Server for generating professional documentation with support for multiple frameworks.

✨ Features

• 🔍 Deep Code Analysis - AST-based Multi-Language Analysis

  • TypeScript/JavaScript: TypeScript Compiler API

  • Python: Native Python AST module

  • Go: Go parser & AST

  • PHP: Regex-based analysis + PHP 8+ Features

  • Extracts classes, functions, interfaces, methods, properties

  • PHP 8+: Enums, Traits, Attributes

  • Captures JSDoc/Docstrings/Go Doc/PHPDoc and calculates documentation coverage

  • Analyzes imports/exports and module dependencies

• 🌍 Multi-Language Projects - Automatic detection and parallel analysis of multiple languages

• 📊 Project Analysis - Automatic code analysis for TypeScript, JavaScript, Python, Go, PHP

• 🏗️ Structure Generation - Creates complete documentation scaffolds

• ✍️ Page Editor - Creates and edits individual documentation pages

• 📖 API Documentation - Generates API docs from code comments

• 🌐 Static Site Builder - Builds static websites for hosting

• 📄 PDF Export - Converts documentation to PDF

• 👀 Live Preview - Local development server

🛠️ Supported Frameworks

• Docusaurus (React-based, modern, various templates)

• MkDocs (Python-based, Markdown-focused, simple)

• Sphinx (Python, very powerful, for complex projects)

🚀 Quick Start

1. Install globally:

   npm install -g documentation-mcp-server

2. Configure in Claude Desktop (see SETUP.md):

   {
     "mcpServers": {
       "docs": {
         "command": "npx",
         "args": ["-y", "documentation-mcp-server"]
       }
     }
   }

3. Start using the documentation tools in Claude!

📦 Tools

docs_analyze_project

Analyzes project structure and performs deep code analysis.

Parameters:

• projectPath (string, required) - Path to project

• language (enum, optional) - Programming language (typescript, javascript, python, go, rust, java, csharp)

• deep (boolean, optional, default: true) - Enables deep code analysis

Deep Analysis Features:

• 📦 Extracts Classes/Structs, Interfaces, Functions, Enums, Type Aliases

• 🔍 Captures Methods, Properties, Constructors with complete details

• 📝 Analyzes JSDoc/Docstrings/Go Doc and calculates documentation coverage

• 🔗 Tracks Imports/Exports and Module Dependencies

• 📊 Generates summary statistics

• 🎯 Multi-Language Support:

  • ✅ TypeScript/JavaScript (TypeScript Compiler API)

  • ✅ Python (Native Python AST)

  • ✅ Go (go/parser & go/ast)

  • ✅ PHP v2 (nikic/php-parser AST) - New! 100% accurate

    • 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

  • 🌍 Automatic Multi-Language Detection

  • 🔜 Rust, Java, C# (planned)

Example Response:

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

docs_generate_structure

Generates documentation scaffold.

Parameters:

• projectPath (string, required) - Path to project

• framework (enum, required) - docusaurus | mkdocs | sphinx

• template (string, optional) - Template name

• outputPath (string, optional) - Output path (default: ./docs)

docs_create_page

Creates or edits documentation page.

Parameters:

• docsPath (string, required) - Path to docs

• pagePath (string, required) - Relative path to page

• title (string, required) - Page title

• content (string, required) - Markdown content

docs_generate_api

Generates API documentation from code.

Parameters:

• projectPath (string, required) - Path to source code

• outputPath (string, required) - Output path

• language (enum, required) - Programming language

docs_build_static

Builds static website.

Parameters:

• docsPath (string, required) - Path to docs

• framework (enum, required) - Framework

• outputPath (string, optional) - Output path (default: ./build)

docs_export_pdf

Exports documentation as PDF.

Parameters:

• docsPath (string, required) - Path to docs

• outputPath (string, required) - PDF output path

• includePages (array, optional) - Specific pages

docs_preview

Starts local dev server.

Parameters:

• docsPath (string, required) - Path to docs

• framework (enum, required) - Framework

• port (number, optional) - Port (default: 3000/8000)

docs_generate_openapi

Generates OpenAPI 3.0 specification from PHP code.

Parameters:

• projectPath (string, required) - PHP project path

• outputPath (string, optional) - Output path (default: ./openapi.json)

• format (enum, optional) - json | yaml (default: json)

• title (string, optional) - API title

• version (string, optional) - API version

• serverUrl (string, optional) - API server URL

docs_generate_sales_docs 🎯 NEW!

Generates professional, sales-ready documentation for CodeCanyon, ThemeForest, etc.

Parameters:

• projectPath (string, required) - PHP project path

• outputDir (string, optional) - Output directory (default: ./sales-docs)

• productName (string, required) - Product name

• productVersion (string, optional) - Version (default: 1.0.0)

• author (string, required) - Author/Company

• description (string, required) - Product description

• price (string, optional) - Price (e.g., "$49")

• demoUrl (string, optional) - Live demo URL

• supportEmail (string, optional) - Support email

• features (array, optional) - List of key features

Generated Files:

1. README.md (2.5 KB) - Product overview with features, statistics, requirements

2. INSTALLATION.md (3.2 KB) - Step-by-step setup guide

3. API_REFERENCE.md (24.2 KB) - Complete API documentation

4. CONFIGURATION.md (2.1 KB) - Environment variables, security

5. EXAMPLES.md (4.0 KB) - Code examples (JS, PHP, Python)

6. FAQ.md (2.2 KB) - Frequently asked questions

7. CHANGELOG.md (0.9 KB) - Version history

8. COMPLETE_DOCUMENTATION.md (39.0 KB) - All-in-one for PDF

Total: ~78 KB professional documentation!

🏗️ Architecture

src/
├── index.ts                    # MCP Server main file
├── core/                       # Core modules for deep analysis
│   ├── types.ts               # Type definitions for all languages
│   └── analyzer.ts            # Abstract base class & factory
├── analyzers/                  # Language-specific analyzers
│   ├── 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 implementations
    ├── analyzeProject.ts      # Deep analysis integration
    ├── generateStructure.ts
    ├── createPage.ts
    ├── generateApi.ts
    ├── buildStatic.ts
    ├── exportPdf.ts
    └── preview.ts

🔬 Deep Analysis Pipeline

1. File Scanning - Scans project directory

2. Language Detection - Detects dominant programming language

3. Analyzer Selection - Selects appropriate AST parser (Factory Pattern)

4. AST Parsing - Parses code files with language-specific parser

   • TypeScript: TS Compiler API (in-process)

   • Python: Python AST module (subprocess)

   • Go: go/parser & go/ast (subprocess)

5. Symbol Extraction - Extracts all code symbols (Classes, Functions, etc.)

6. Documentation Analysis - Captures documentation comments

7. Summary Generation - Calculates statistics and coverage

📝 License

MIT