ProjectHub-Mcp

ProjectHub-MCP v5.0.0

---

🎯 Overview

ProjectHub-MCP is a cutting-edge project management platform designed for modern development teams. Built with enterprise-grade architecture and featuring a sleek dark theme with signature orange accents, it delivers powerful tools for managing projects, tracking tasks, and analyzing team performance in real-time.

🏆 Why Choose ProjectHub-MCP?

• 🚀 Modern Stack: Alpine.js frontend, Node.js/Express backend, PostgreSQL database
• 🎨 Professional UI: Dark theme with custom orange branding (#ff6500)
• 📊 Real Analytics: Live dashboards with actual data calculations
• 🤖 AI Ready: Full Claude Code and MCP protocol integration
• 🔒 Enterprise Security: JWT auth, bcrypt encryption, rate limiting
• 🐳 Container First: Complete Docker orchestration with health checks
• ⚡ Real-time: Instant updates with live data synchronization

✨ Features

📋 Project Management

• Complete CRUD Operations: Create, read, update, and delete projects with cascade deletion
• Status Tracking: Planning → Active → Paused → Completed → Cancelled
• Progress Visualization: Real-time progress bars and completion tracking
• Project Analytics: Individual project metrics and performance insights

✅ Task Management

• Interactive Kanban Board: Drag-and-drop interface with project switching
• Priority Levels: High, Medium, Low with visual color coding
• Status Management: Todo → In Progress → Done with seamless transitions
• Time Tracking: Estimated vs actual time comparison and logging
• Task Dependencies: Link related tasks and track blockers

📊 Analytics Dashboard

• Real-Time Metrics: Live calculation of project and task statistics
• Visual Charts: Project status distribution, task priority breakdown
• Performance Tracking: Team productivity and velocity measurements
• Data Export: Export analytics in multiple formats

👥 Team Collaboration

• Role-Based Access: Admin controls with secure authentication
• Activity Tracking: Monitor all project and task modifications
• User Management: Secure login/logout with session management

🔔 Integrations

• Webhook Support: Connect to Slack, Discord, Teams with CORS handling
• API Access: Full RESTful API with comprehensive endpoints
• MCP Protocol: Native support for AI coding assistants like Claude Code
• Health Monitoring: Complete system health checks and status reporting

🖼️ Screenshots

Login Screen

Clean login interface with demo credentials shown. Features dark theme with signature orange (#ff6500) branding.

Dashboard Overview

Modern dashboard with live project and task statistics. Shows current workspace with 2 projects, 32 tasks, and real-time completion tracking.

Kanban Board

Interactive kanban board with project selector and task management. Clean interface ready for drag-and-drop functionality.

Analytics Dashboard

Comprehensive analytics with real charts and live data. Features project status distribution, task priority breakdown, and activity timeline.

🚀 Quick Start

Ready to start in 5 minutes? → Follow the Quick Start Guide

Need detailed installation help? → Read the Installation Guide

TL;DR - One Command Setup

git clone https://github.com/anubissbe/ProjectHub-Mcp.git && cd ProjectHub-Mcp && cp .env.example .env && echo "JWT_SECRET=$(openssl rand -base64 32)" >> .env && docker-compose up -d

Then open: http://localhost:5174 (admin@projecthub.com / admin123)

🚀 Uses pre-built Docker Hub images - No building required! Pulls anubissbe/projecthub-backend:latest and anubissbe/projecthub-frontend:latest

🏭 Production Deployment

Production URLs (update with your server details):

• Frontend: http://your-server:5174
• Backend API: http://your-server:3009
• Health: http://your-server:3009/health
• Credentials: admin@projecthub.com / admin123

🏗️ Architecture

graph TD
    A[Alpine.js Frontend<br/>Port 5174] -->|REST API| B[Node.js Backend<br/>Port 3009]
    B --> C[PostgreSQL DB<br/>Port 5434]
    B --> D[MCP Protocol]
    B --> E[Health Monitoring]
    B --> F[Webhook System]
    
    style A fill:#ff6500,stroke:#fff,color:#fff
    style B fill:#68a063,stroke:#fff,color:#fff
    style C fill:#336791,stroke:#fff,color:#fff

Technology Stack

Frontend	Backend	Database
Alpine.js 3.x	Node.js 18+	PostgreSQL 15+
Tailwind CSS 3.4	Express 4.21	Redis (optional)
Chart.js 4.4	JWT Authentication	Docker containers
SortableJS	bcrypt encryption	Health monitoring

📖 API Reference

Core Endpoints

# Authentication
POST   /api/auth/login          # User login
POST   /api/auth/logout         # User logout
GET    /api/auth/profile        # Get current user

# Projects
GET    /api/projects            # List all projects
POST   /api/projects            # Create new project
GET    /api/projects/:id        # Get project details
PUT    /api/projects/:id        # Update project
DELETE /api/projects/:id        # Delete project (cascade)

# Tasks
GET    /api/tasks               # List all tasks
GET    /api/tasks?projectId=:id # Get tasks for project
POST   /api/tasks               # Create new task
PUT    /api/tasks/:id           # Update task
DELETE /api/tasks/:id           # Delete task

# Analytics
GET    /api/analytics           # Global analytics
GET    /api/analytics?projectId=:id # Project analytics

# Health & Monitoring
GET    /health                  # System health check
GET    /metrics                 # Prometheus metrics

Example Usage

// Authenticate and create a project
const auth = await fetch('http://localhost:3009/api/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'admin@projecthub.com',
    password: 'admin123'
  })
});

const { token } = await auth.json();

const project = await fetch('http://localhost:3009/api/projects', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'New Project',
    description: 'Project description',
    status: 'active'
  })
});

🤖 AI Integration

ProjectHub-MCP provides native support for AI coding assistants through the MCP (Model Context Protocol).

🎯 Quick Setup with Claude Code

# 1. Start ProjectHub
docker-compose up -d

# 2. Test API connectivity
curl http://localhost:3009/health

# 3. Use in Claude Code
# Add to your project's CLAUDE.md:
echo "ProjectHub API: http://localhost:3009/api" >> CLAUDE.md
echo "Login: admin@projecthub.com / admin123" >> CLAUDE.md

Supported AI Tools

• ✅ Claude Code (Anthropic) - Native MCP support
• ✅ GitHub Copilot - API integration
• ✅ Cursor - REST API calls
• ✅ Continue.dev - Custom MCP client
• ✅ Windsurf - API integration

Example AI Workflow

👤 You: "Create a project for implementing user authentication"
🤖 Claude: "✅ Created project 'User Authentication System' with 5 tasks"

👤 You: "Start working on the JWT implementation task"  
🤖 Claude: "✅ Updated task status to 'in_progress'"

👤 You: "Task completed, took 4 hours"
🤖 Claude: "✅ Marked complete, logged 4 actual hours vs 3 estimated"

📖 Complete AI Integration Guide

🚦 Monitoring & Health

Health Check Endpoints

# System health (comprehensive)
curl http://localhost:3009/health

# Database connectivity  
curl http://localhost:3009/api/health/db

# Frontend availability
curl http://localhost:5174

# Container status
docker-compose ps

Performance Metrics

• API Response Time: < 100ms average
• Database Queries: < 50ms
• Page Load: < 2 seconds
• Real-time Updates: < 100ms latency

🧪 Testing & Quality

# Backend testing
cd backend-fix
npm test

# Health check testing
npm run test:health

# API endpoint testing
npm run test:api

# Database testing
npm run test:db

🔧 Configuration

Environment Variables

# Required
JWT_SECRET=your-secure-jwt-secret-here
POSTGRES_PASSWORD=your-secure-db-password

# Optional
CORS_ORIGIN=http://localhost:5174
NODE_ENV=production
BACKEND_PORT=3009
FRONTEND_PORT=5174

Docker Configuration

# docker-compose.yml
services:
  backend:
    image: anubissbe/projecthub-backend:latest
    ports:
      - "3009:3010"
    environment:
      JWT_SECRET: ${JWT_SECRET}
      
  frontend:
    image: anubissbe/projecthub-frontend:latest
    ports:
      - "5174:80"
      
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}

📈 Recent Updates

v5.0.0 (Latest)

• ✅ Fixed Kanban Board: Project switching now works correctly
• ✅ Enhanced Security: Improved JWT handling and bcrypt encryption
• ✅ Real Analytics: All dashboard metrics calculated from live data
• ✅ Cascade Deletion: Safe project deletion with task cleanup
• ✅ Docker Optimization: Improved container health checks
• ✅ API Stability: Fixed task update endpoints and field validation

v4.8.0

• 🔔 Webhook integration with CORS proxy
• 👤 Enhanced user management system
• 📧 Email notification system
• 🎯 Task dependency tracking

View Full Changelog

🤝 Contributing

We welcome contributions! Please follow these steps:

# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/ProjectHub-Mcp.git
cd ProjectHub-Mcp

# 2. Create feature branch
git checkout -b feature/your-feature-name

# 3. Make changes and test
docker-compose up -d
npm test

# 4. Submit pull request

Development Guidelines

• Follow existing code style and patterns
• Add tests for new features
• Update documentation
• Test with Docker containers
• Ensure health checks pass

📞 Support & Documentation

Resource	Link	Description
🐛 Bug Reports	GitHub Issues	Report bugs and issues
💬 Discussions	GitHub Discussions	Community support
📖 Wiki	GitHub Wiki	Complete documentation
🚀 Releases	GitHub Releases	Latest versions

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---