-
securityF
license-
qualityProvides a scalable, containerized infrastructure for deploying and managing Model Context Protocol servers with monitoring, high availability, and secure configurations.
Last updated -
Manages environment variables for configuration of the MCP server in different deployment environments
Serves as the backend framework for the MCP server, handling API routes, middleware, and HTTP requests
Powers the backend runtime environment for the MCP server, providing the foundation for server-side JavaScript execution
Provides the frontend dashboard interface for monitoring and managing the MCP server, with features like context browsing and system statistics
Offers streamlined deployment of the MCP server with included configuration via render.yaml for automated build and deployment processes
Adds static typing to both frontend and backend codebases, enhancing code quality and developer experience
MCP Server - Production Monorepo
A production-grade Model Context Protocol (MCP) server with a beautiful React dashboard, built with security, scalability, and maintainability in mind.
🚀 Features
Backend (Node.js + Express + TypeScript)
- Full MCP Protocol Compliance - Complete implementation of the Model Context Protocol
- Secure ZIP Processing - Advanced security validation, zip bomb protection, path traversal prevention
- Context Management - Approval workflow for uploaded content
- System Snapshots - Comprehensive state snapshots with configurable options
- Production Security - Rate limiting, CORS, helmet, input validation
- Structured Logging - Winston-based logging with rotation and levels
- Health Monitoring - Comprehensive health checks and system statistics
Frontend (React + TypeScript + Tailwind)
- Modern Dashboard - Beautiful, responsive interface with dark/light mode
- Real-time Monitoring - Live system stats, logs, and activity feeds
- Secure File Upload - Drag-and-drop ZIP upload with progress tracking
- Context Browser - Search, filter, and manage uploaded contexts
- Log Viewer - Real-time log streaming with filtering and export
- Tool Management - MCP tool monitoring and configuration
MCP Tools
- load_zip - Securely extract and process ZIP archives
- mark_approved - Context approval workflow management
- snapshot - Create comprehensive system state snapshots
🏗️ Architecture
🚦 Quick Start
Prerequisites
- Node.js 18+
- npm 8+
Local Development
- Clone and install dependencies:
- Start development servers:
This starts both the backend (port 3001) and frontend (port 5173) in development mode.
- Access the application:
- Dashboard: http://localhost:5173
- API: http://localhost:3001
- Health Check: http://localhost:3001/api/health
Production Build
🔧 Configuration
Environment Variables
Create a .env file in the backend directory:
Security Configuration
The server includes comprehensive security measures:
- File Upload Limits: 50MB max file size, ZIP files only
- Rate Limiting: 5 uploads per 15 minutes, 100 API calls per 15 minutes
- ZIP Security: Zip bomb protection, path traversal prevention, file type validation
- Input Validation: Joi-based validation for all endpoints
- CORS: Configurable cross-origin resource sharing
- Helmet: Security headers and CSP
📡 API Endpoints
MCP Tools
POST /api/mcp/tools/load-zip- Upload and extract ZIP filesPOST /api/mcp/tools/mark-approved- Approve/reject contextsPOST /api/mcp/tools/snapshot- Create system snapshots
Data Management
GET /api/context- List contexts with filtering and paginationGET /api/logs- Retrieve system logsGET /api/stats- System statistics and metricsGET /api/mcp/tools- List available MCP tools
System
GET /api/health- Health check endpoint
🔒 Security Features
ZIP File Processing
- File Type Validation: Only ZIP files accepted
- Size Limits: 50MB upload limit, 100MB extraction limit
- Zip Bomb Protection: Compression ratio analysis
- Path Traversal Prevention: Sanitized file paths
- Content Filtering: Allowed file extensions only
API Security
- Rate Limiting: Configurable request limits
- Input Validation: Comprehensive request validation
- Error Handling: Secure error responses
- CORS Configuration: Controlled cross-origin access
- Security Headers: Helmet.js integration
🚀 Deployment
Render (Recommended)
The project includes a render.yaml configuration for easy deployment:
- Connect your repository to Render
- The build and deployment will happen automatically
- Environment variables are configured in the YAML file
Manual Deployment
- Build the project:
- Set environment variables:
- Start the server:
📊 Monitoring
Dashboard Features
- System Overview: Uptime, file counts, memory/disk usage
- Real-time Logs: Live log streaming with filtering
- Context Management: Upload approval workflow
- Tool Monitoring: MCP tool usage statistics
Logging
- Structured Logging: JSON format with metadata
- Log Rotation: Automatic log file rotation
- Multiple Levels: Error, warn, info, debug
- Export Capability: Download logs for analysis
🧪 Testing
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Support
For support and questions:
- Check the Issues page
- Review the API documentation
- Check the logs for error details
🔄 Version History
- v1.0.0 - Initial release with full MCP protocol support
- Production-ready security features
- Complete React dashboard
- Render deployment configuration
This server cannot be installed
A production-grade Model Context Protocol server that enables secure management of context data through a React dashboard, supporting ZIP processing, context approval workflows, and system monitoring.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.Last updated -1TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.Last updated -2PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.Last updated -5PythonMIT License