Enables containerized deployment of the chat support system using Docker Compose
Manages environment variables for server configuration, database connections, authentication, and third-party service integration
Enforces code quality and consistency through linting for the TypeScript codebase
Powers the RESTful API backend with route handlers for chat, knowledge base, and authentication endpoints
Supports the contribution workflow with branch management and version control
Provides OAuth integration for user authentication
Offers a deployment target for the React frontend
Serves as the runtime environment for the backend server
Manages package dependencies for both frontend and backend components
Maintains consistent code formatting across the codebase
Provides a deployment platform option for the backend server
Powers the frontend UI with components for chat interface, admin dashboard, and knowledge base
Handles frontend navigation between different sections of the application
Offers a deployment platform option for the backend server
Enables real-time bidirectional communication for live chat features and typing indicators
Stores application data with TypeORM integration for database operations
Processes payments for the subscription-based service
Provides utility-first CSS framework for styling the responsive UI
Manages database entities and relationships with migration support
Ensures type safety throughout both frontend and backend codebases
Offers a deployment platform option for the React frontend
Builds and bundles the frontend application with fast development server
Enables peer-to-peer video conferencing capabilities within the chat interface
Provides an alternative package manager for dependency installation
MCP Chat Support System
A comprehensive chat support system with React frontend and Node.js backend, featuring real-time messaging, knowledge base management, and multi-tenant architecture.
🚀 Features
Frontend (React + TypeScript)
Modern UI/UX: Responsive design with mobile optimization
Real-time Chat: WebSocket-based live messaging
Authentication: Google OAuth integration
Demo Mode: Interactive demo with simulated features
Payment Integration: Stripe payment processing
Video Calls: WebRTC video conferencing
Knowledge Base: Searchable documentation system
Admin Dashboard: Multi-tenant management interface
Offline Support: Service worker for offline functionality
Backend (Node.js + TypeScript)
RESTful API: Express.js server with TypeScript
WebSocket Server: Real-time communication
Database: SQLite with TypeORM
Authentication: JWT token-based auth
Multi-tenancy: Tenant isolation and management
File Upload: Secure file handling
Analytics: Usage tracking and reporting
Widget System: Embeddable chat widgets
📁 Project Structure
🛠️ Tech Stack
Frontend
React 18 with TypeScript
Vite for build tooling
Tailwind CSS for styling
React Router for navigation
Socket.io Client for real-time features
Stripe for payments
WebRTC for video calls
Backend
Node.js with TypeScript
Express.js framework
Socket.io for WebSocket server
SQLite database with TypeORM
JWT for authentication
Multer for file uploads
Cors for cross-origin requests
🚀 Quick Start
Prerequisites
Node.js 18+
npm or yarn
Git
Frontend Setup
Backend Setup
Environment Variables
Create a .env
file in the server directory:
📱 Features Overview
Chat Interface
Real-time messaging with typing indicators
File sharing and image uploads
Message history and search
Read receipts and delivery status
Knowledge Base
Searchable documentation
Category organization
Rich text editing
Version control
Admin Dashboard
Multi-tenant management
User analytics and reporting
System configuration
Widget customization
Widget System
Embeddable chat widgets
Customizable appearance
Multi-language support
Mobile responsive
🔧 Development
Code Style
TypeScript for type safety
ESLint for code linting
Prettier for code formatting
Husky for git hooks
Testing
Database Migrations
🚀 Deployment
Frontend (Vercel/Netlify)
Backend (Render/Railway)
Gemini MCP Server (Hugging Face Spaces)
The Gemini MCP Server can be deployed to Hugging Face Spaces for free:
📖 For detailed deployment instructions, see:
Quick Steps:
Get a free Google Gemini API key from Google AI Studio
Create a new Space on Hugging Face Spaces
Choose "Docker" as the SDK
Connect your GitHub repository
Set the
GEMINI_API_KEY
environment variableDeploy!
Cost: $0 (free tier available for both Hugging Face Spaces and Google Gemini API)
Node.js Backend (Hugging Face Spaces)
The Node.js/Express backend can also be deployed to Hugging Face Spaces:
📖 For detailed deployment instructions, see:
Quick Steps:
Create a new Space on Hugging Face Spaces
Choose "Docker" as the SDK
Connect your GitHub repository
Set the
JWT_SECRET
environment variableDeploy!
Cost: $0 (free tier available for Hugging Face Spaces)
Docker Deployment
📊 API Documentation
Authentication Endpoints
POST /api/auth/login
- User loginPOST /api/auth/register
- User registrationPOST /api/auth/google
- Google OAuthGET /api/auth/profile
- Get user profile
Chat Endpoints
GET /api/chat/messages
- Get chat historyPOST /api/chat/messages
- Send messageGET /api/chat/rooms
- Get chat rooms
Knowledge Base Endpoints
GET /api/knowledge
- Get knowledge articlesPOST /api/knowledge
- Create articlePUT /api/knowledge/:id
- Update articleDELETE /api/knowledge/:id
- Delete article
🤝 Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature
)Commit your changes (
git commit -m 'Add amazing feature'
)Push to the branch (
git push origin feature/amazing-feature
)Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Support
For support and questions:
Create an issue on GitHub
Check the documentation in the
/docs
folderReview the deployment guides
🔗 Links
Made with ❤️ by [Your Name]
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A comprehensive customer support platform featuring real-time messaging, knowledge base management, and a multi-tenant architecture with both React frontend and Node.js backend.
Related MCP Servers
- -securityAlicense-qualityThis server provides a comprehensive integration with Zendesk. Retrieving and managing tickets and comments. Ticket analyzes and response drafting. Access to help center articles as knowledge base.Last updated -32Apache 2.0
- AsecurityAlicenseAqualityA comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.Last updated -75MIT License
- -securityAlicense-qualityA MCP-based intelligent customer service system that provides smart Q\&A, human agent transfer, order inquiries, and product knowledge management.Last updated -5MIT License
- -securityFlicense-qualityAn advanced management platform that integrates FastAPI and React TypeScript, providing a modern user interface with SQLite database and action history tracking.Last updated -