Bishop MCP logo

Bishop MCP

by mbishopfx

Bishop MCP is an advanced, enterprise-grade Master Control Program for efficient app building, deployment, and management in Cursor IDE. It provides a comprehensive suite of tools for managing your development workflow, from build automation to deployment orchestration.

View on GitHub

Last updated: N/A

Bishop MCP (Master Control Program)

An advanced, enterprise-grade Master Control Program for efficient app building, deployment, and management in Cursor IDE. This system provides a comprehensive suite of tools for managing your development workflow, from build automation to deployment orchestration.

🌟 Features

Core Functionality

  • Advanced Build System

    • Concurrent build management
    • Build artifact caching
    • Version control integration
    • Build logs and metrics
    • Artifact retention policies
  • Deployment Orchestration

    • Multi-environment support (Dev/Staging/Prod)
    • Zero-downtime deployments
    • Automatic rollback capabilities
    • Health check monitoring
    • Deployment configuration management
  • User Management

    • Role-based access control (RBAC)
    • JWT authentication
    • Session management
    • User activity tracking

Advanced Features

Real-time Monitoring
  • WebSocket-based real-time updates
  • Build and deployment progress tracking
  • System metrics visualization
  • Resource usage monitoring
  • Custom alert configurations
Security
  • Rate limiting protection
  • HTTPS support
  • CORS configuration
  • JWT-based authentication
  • Role-based access control
  • Security headers with Helmet
Logging and Analytics
  • Structured JSON logging
  • Log rotation
  • Audit trails
  • Performance metrics
  • Error tracking and reporting
Integration Capabilities
  • Docker container support
  • Git repository integration
  • CI/CD pipeline hooks
  • Webhook support
  • Email notifications
  • Redis caching
Monitoring and Metrics
  • Prometheus integration
  • Grafana dashboards
  • Health check endpoints
  • Performance monitoring
  • Resource usage tracking

🚀 Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • PostgreSQL (v13 or higher)
  • Redis (v6 or higher)
  • Docker (optional)

Installation

  1. Clone the repository:
git clone https://github.com/your-username/bishop-mcp.git
cd bishop-mcp
  1. Install dependencies:
npm install
  1. Set up environment variables:
cp .env.example .env
# Edit .env with your configuration
  1. Set up the database:
# Start PostgreSQL
npm run migrate:up
npm run seed
  1. Start the server:
# Development
npm run dev

# Production
npm run build
npm start

Docker Deployment

  1. Build the Docker image:
npm run docker:build
  1. Run the container:
npm run docker:run

📚 API Documentation

Authentication

  • POST /api/auth/login
  • POST /api/auth/register
  • POST /api/auth/refresh-token
  • POST /api/auth/logout

Apps

  • GET /api/apps
  • GET /api/apps/:id
  • POST /api/apps
  • PUT /api/apps/:id
  • DELETE /api/apps/:id

Builds

  • POST /api/apps/:id/build
  • GET /api/apps/:id/builds
  • GET /api/apps/:id/builds/:buildId
  • DELETE /api/apps/:id/builds/:buildId
  • GET /api/apps/:id/builds/:buildId/status
  • GET /api/apps/:id/builds/:buildId/logs
  • GET /api/apps/:id/builds/:buildId/artifacts

Deployments

  • POST /api/apps/:id/deploy
  • GET /api/apps/:id/deployments
  • GET /api/apps/:id/deployments/:deploymentId
  • POST /api/apps/:id/deployments/:deploymentId/rollback
  • DELETE /api/apps/:id/deployments/:deploymentId
  • GET /api/apps/:id/deployments/:deploymentId/status
  • GET /api/apps/:id/deployments/:deploymentId/logs

Environments

  • GET /api/environments
  • POST /api/environments
  • PUT /api/environments/:id
  • DELETE /api/environments/:id

🔧 Configuration

Environment Variables

  • Server Configuration

    • PORT: Server port (default: 3000)
    • NODE_ENV: Environment mode
    • DATABASE_URL: PostgreSQL connection string
  • Security

    • JWT_SECRET: JWT signing key
    • JWT_EXPIRES_IN: Token expiration
    • RATE_LIMIT_WINDOW: Rate limiting window
    • RATE_LIMIT_MAX_REQUESTS: Maximum requests per window
  • Build System

    • BUILD_TIMEOUT: Maximum build duration
    • MAX_CONCURRENT_BUILDS: Concurrent build limit
    • BUILD_CACHE_TTL: Cache retention period
    • BUILD_ARTIFACT_RETENTION_DAYS: Artifact retention period
  • Deployment

    • DEPLOYMENT_TIMEOUT: Maximum deployment duration
    • MAX_CONCURRENT_DEPLOYMENTS: Concurrent deployment limit
    • DEPLOYMENT_ROLLBACK_ENABLED: Enable automatic rollbacks
    • DEPLOYMENT_HEALTH_CHECK_TIMEOUT: Health check timeout

📊 Monitoring

Metrics

Access metrics dashboard:

http://localhost:9090/metrics

Grafana Integration

  1. Configure Grafana datasource with Prometheus
  2. Import provided dashboards from /grafana/dashboards

🔒 Security

Authentication

  • JWT-based authentication
  • Role-based access control
  • Rate limiting protection
  • CORS configuration

SSL/TLS

Enable HTTPS in production:

  1. Set ENABLE_HTTPS=true in .env
  2. Provide SSL certificate paths:
    • SSL_CERT_PATH
    • SSL_KEY_PATH

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

📝 License

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

🙏 Acknowledgments

  • Built with TypeScript and Node.js
  • Powered by Express.js
  • Database by PostgreSQL
  • Caching by Redis
  • Containerization by Docker
  • Monitoring by Prometheus & Grafana