# 🌐 DocuMind MCP Server > _"Where Documentation Meets Digital Intelligence"_ A next-generation Model Context Protocol (MCP) server that revolutionizes documentation quality analysis through advanced neural processing. ## ⚡ Core Systems - 🧠 **Neural Documentation Analysis**: Advanced algorithms for comprehensive README evaluation - 🔮 **Holographic Header Scanning**: Cutting-edge SVG analysis for visual elements - 🌍 **Multi-dimensional Language Support**: Cross-linguistic documentation verification - 💫 **Quantum Suggestion Engine**: AI-powered improvement recommendations ## 🚀 System Boot Sequence ### System Requirements - Node.js 18+ - npm || yarn ### Initialize Core ```bash npm install ``` ### Compile Matrix ```bash npm run build ``` ### Neural Development Link Establish real-time neural connection: ```bash npm run watch ``` ## 🛸 Operation Protocol ### System Configuration Integrate with Claude Desktop mainframe: **Windows Terminal**: ```json // %APPDATA%/Claude/claude_desktop_config.json { "mcpServers": { "documind-mcp-server": { "command": "/path/to/documind-mcp-server/build/index.js" } } } ``` ### Neural Interface Commands #### evaluate_readme Initiates quantum analysis of documentation structure. Parameters: - `projectPath`: Neural pathway to target directory Example Request: ```javascript { name: "evaluate_readme", arguments: { projectPath: "/path/to/project" } } ``` Example Response: ```javascript { content: [ { type: "text", text: JSON.stringify({ filePath: "/path/to/project/README.md", hasHeaderImage: true, headerImageQuality: { hasGradient: true, hasAnimation: true, // ... other quality metrics }, score: 95, suggestions: [ "Consider adding language badges", // ... other suggestions ] }) } ] } ``` ## 🔮 Development Matrix ### Debug Protocol Access the neural network through MCP Inspector: ```bash npm run inspector ``` ### Troubleshooting Guide #### Common Issues and Solutions 1. **Header Image Not Detected** - Ensure SVG file is placed in the `assets/` directory - Validate SVG file contains proper XML structure - Check file permissions 2. **Language Badges Not Recognized** - Verify badges use shields.io format - Check HTML structure follows recommended pattern - Ensure proper center alignment 3. **Build Errors** - Clear `node_modules` and reinstall dependencies - Ensure TypeScript version matches project requirements - Check for syntax errors in modified files 4. **MCP Connection Issues** - Verify stdio transport configuration - Check Claude Desktop configuration - Ensure proper file paths in config #### Performance Optimization 1. **SVG Analysis** - Minimize SVG complexity for faster parsing - Use efficient gradients and animations - Optimize file size while maintaining quality 2. **README Scanning** - Structure content for optimal parsing - Use recommended markdown patterns - Follow badge placement guidelines ## 🔬 API Documentation ### Core Classes #### ReadmeService Primary service for README analysis and evaluation. ```typescript class ReadmeService { // Analyzes all README files in a project async evaluateAllReadmes(projectPath: string): Promise // Evaluates a single README file private async evaluateReadme(dirPath: string, readmePath: string): Promise // Evaluates language badge configuration private evaluateLanguageBadges(content: string): BadgeEvaluation } ``` #### SVGService Specialized service for SVG header image analysis. ```typescript class SVGService { // Evaluates SVG header image quality public evaluateHeaderImageQuality(imgSrc: string, content: string): HeaderImageQuality // Checks for project-specific elements in SVG private checkProjectSpecificImage(svgContent: string, readmeContent: string): boolean } ``` ### Core Interfaces ```typescript interface ReadmeEvaluation { filePath: string; hasHeaderImage: boolean; headerImageQuality: HeaderImageQuality; isCentered: { headerImage: boolean; title: boolean; badges: boolean; }; hasBadges: { english: boolean; japanese: boolean; isCentered: boolean; hasCorrectFormat: boolean; }; score: number; suggestions: string[]; } interface HeaderImageQuality { hasGradient: boolean; hasAnimation: boolean; hasRoundedCorners: boolean; hasEnglishText: boolean; isProjectSpecific: boolean; } ``` ### Error Handling The server implements comprehensive error handling: ```typescript try { const evaluations = await readmeService.evaluateAllReadmes(projectPath); // Process results } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: 'text', text: `Evaluation error: ${errorMessage}` }], isError: true }; } ``` ## ⚡ License Operating under MIT Protocol.