DOCUMENTATION_INDEX.mdā¢4.46 kB
# Mermaid Validator MCP Server - Documentation Index
This document provides a comprehensive overview of all documentation available for the Mermaid Validator MCP Server project.
## š Core Documentation
### Getting Started
- **[README.md](README.md)** - Main project overview and quick start guide
- **[GETTING_STARTED.md](GETTING_STARTED.md)** - Detailed setup and configuration instructions
### MCP Server Documentation
- **[MCP API Documentation](docs/api/README-MCP.md)** - Complete MCP server API reference and usage guide
## š Architecture & Development
### Architecture Documentation
- **[Parser Architecture](docs/architecture/PARSER_ARCHITECTURE.md)** - Grammar parser system design and implementation
- **[Project Structure](docs/guides/PROJECT_STATUS.md)** - Current project status and component overview
### Development Guides
- **[Build Instructions](docs/guides/BUILD_INSTRUCTIONS.md)** - How to build and compile the project
- **[Validation Summary](docs/guides/VALIDATION_SUMMARY.md)** - Comprehensive validation capabilities overview
## š Deployment & Operations
### Deployment Documentation
- **[Deployment Guide](docs/deployment/DEPLOYMENT.md)** - Production deployment instructions
- **[Environment Configuration](docs/deployment/ENVIRONMENT.md)** - Environment variables and configuration options
## š Examples & Testing
### Example Diagrams
- **[Example Diagrams](examples/diagrams/)** - Sample Mermaid diagrams for testing and reference
- All 28 supported diagram types
- Valid and invalid syntax examples
- Comprehensive test cases
### Testing
- **[MCP Integration Tests](tests/mcp/test-mcp-integration.js)** - Automated MCP server functionality tests
## š Security & Compliance
### Security Documentation
- **[SECURITY.md](SECURITY.md)** - Security policies and vulnerability reporting
- **[Code of Conduct](CODE_OF_CONDUCT.md)** - Community guidelines and behavior expectations
### Compliance & Legal
- **[License Information](LICENSE)** - Project licensing terms
- **[Contributing Guidelines](CONTRIBUTING.md)** - How to contribute to the project
- **[Support Information](SUPPORT.md)** - How to get help and support
## š¤ Community & Collaboration
### Project Governance
- **[Starter Team Information](STARTER_TEAM.md)** - Initial development team and responsibilities
- **[Pull Request Template](.github/pull_request_template.md)** - PR submission guidelines
- **[Code Owners](CODEOWNERS)** - Project maintainers and code review assignments
## š§ Configuration Files
### Build & Development Configuration
- **[Package Configuration](package.json)** - Node.js dependencies and scripts
- **[TypeScript Configuration](tsconfig.json)** - TypeScript compiler settings
- **[TypeScript MCP Configuration](tsconfig.mcp.json)** - MCP-specific TypeScript settings
### Quality & Security Configuration
- **[ESLint Configuration](.eslintrc.js)** - Code linting rules
- **[Audit Configuration](audit-ci.json)** - Security audit settings
- **[Langium Configuration](langium-config.json)** - Grammar parser configuration
## š Project Status
### Current Status
- ā
**Core Functionality**: Complete validation system with 28 diagram types
- ā
**MCP Server**: Full Model Context Protocol implementation
- ā
**Multiple Transports**: Stdio, HTTP, and Secure HTTP transports
- ā
**Security Features**: Production-ready security and audit features
- ā
**Documentation**: Comprehensive documentation suite
### Architecture Overview
```
mermaid-validator-mcp/
āāā src/mcp/ # MCP server implementation
ā āāā server.ts # Core MCP server (stdio)
ā āāā server-http.ts # HTTP transport server
ā āāā server-secure.ts # Secure production server
ā āāā tools/ # MCP tool implementations
ā āāā transports/ # Transport layer implementations
ā āāā middleware/ # Security middleware
ā āāā schemas/ # Validation schemas
āāā src/services/ # Core validation services
āāā docs/ # Organized documentation
āāā examples/diagrams/ # Example Mermaid diagrams
āāā tests/mcp/ # MCP-specific tests
āāā dist/ # Compiled TypeScript output
```
For specific implementation details, refer to the individual documentation files linked above.