Skip to main content

​
Overview

MCP Enterprise is the administrative interface for managing MCP servers. It consists of a Python backend (FastAPI) and Vue.js frontend, providing a comprehensive dashboard with Role-Based Access Control (RBAC) features.

​
Features

  • Server Management Dashboard
  • User and Role Management
  • Resource Monitoring
  • Configuration Management
  • Audit Logging

​
Installation

​
Prerequisites

  • Python 3.8+
  • Node.js 14+
  • PostgreSQL
  • Docker (optional)

​
Prerequisites

Before starting the installation, ensure you have:
  • Node.js and npm
  • Docker and Docker Compose
  • Python 3.10+
  • Poetry

​
Installation Steps

  1. Clone the Repository
git clone [email protected]:Rizz-Buzz/mcp-enterprise.git
cd mcp-enterprise
  1. Set Up Environment Variables
cp .env.example .env.dev
The .env.example provides most default values. The only required change is setting PYTHONPATH to point to the backend/apps/admin folder path.
  1. Install Dependencies and Initialize Database
make install
This command will:
  • Set up the PostgreSQL database
  • Install backend dependencies using Poetry
  • Install frontend dependencies using npm

​
Starting the Services

You’ll need two terminal windows to run the services: 
# Terminal 1: Start the Admin Backend
make run-backend

# Terminal 2: Start the Admin Frontend
make run-frontend
The admin dashboard will be available at http://localhost:5199.

​
First-Time Setup

When you first access the dashboard:
  • Navigate to http://localhost:5199
  • The first login will automatically grant you admin access
  • Set up additional users and roles as needed
The admin dashboard will be available at http://localhost:5199.

​
Core Components

​
1. Server Management

The server management interface allows you to:
  • Add and configure MCP servers
  • Monitor server status
  • Set resource limits
  • Configure server tools
  • View server logs

​
2. User Management

Comprehensive user management includes:
  • User creation and management
  • Role assignment
  • Permission configuration
  • Activity monitoring
  • Access control

​
3. RBAC System

The Role-Based Access Control system provides:
  • Role definition
  • Permission management
  • Access policy creation
  • Activity auditing

​
4. Resource Management

Monitor and manage resources through:
  • Resource usage tracking
  • Limit configuration
  • Resource allocation
  • Usage analytics

​
Configuration

​
Database Configuration

Configure PostgreSQL connection in .env: 
DB_USER=postgres_user
DB_PASSWORD=your-password
DB_NAME=mcp-enterprise
DB_PORT=5488
DB_HOST=localhost

​
RBAC Configuration

Define roles and permissions in the admin interface:
  1. Create roles (e.g., admin, manager, user)
  2. Define permissions for each role
  3. Assign users to roles
  4. Configure access policies

​
Server Integration

Configure MCP Hub integration: 
{
  "mcpServers": {
    "default": {
      "url": "http://localhost:3000",
      "apiKey": "your-api-key"
    }
  }
}

​
Usage Guide

​
Managing Servers

  1. Adding a New Server
    • Navigate to Servers > Add New
    • Configure server details
    • Set resource limits
    • Configure tools
  2. Monitoring Servers
    • View server status
    • Check resource usage
    • Monitor performance
    • View logs

​
User Management

  1. Creating Users
    • Navigate to Users > Add New
    • Set user details
    • Assign roles
    • Configure permissions
  2. Managing Roles
    • Create/edit roles
    • Define permissions
    • Set access policies

​
Security Considerations

  1. Authentication
    • Use strong passwords
    • Enable 2FA if available
    • Regular token rotation
    • Session management
  2. Authorization
    • Proper role configuration
    • Least privilege principle
    • Regular access review
    • Audit logging
  3. Data Protection
    • Database security
    • API security
    • Data encryption
    • Secure communication

​
Best Practices

  1. Server Management
    • Regular monitoring
    • Resource optimization
    • Performance tuning
    • Regular updates
  2. User Management
    • Regular access review
    • Role optimization
    • Activity monitoring
    • Security training
  3. Resource Management
    • Capacity planning
    • Usage optimization
    • Cost monitoring
    • Regular audits

​
Troubleshooting

​
Common Issues

  1. Database Connection 
    # Check database status
pg_isready -h localhost -p 5488

# Verify connection string
echo $DATABASE_URL
  2. Server Integration
    • Verify MCP Hub connection
    • Check API keys
    • Validate URLs
    • Review logs
  3. Frontend Issues
    • Check API endpoints
    • Verify environment variables
    • Clear browser cache
    • Check console errors

​
Maintenance

​
Regular Tasks

  1. Database Maintenance 
    # Backup database
pg_dump -U $DB_USER -d $DB_NAME > backup.sql

# Vacuum database
vacuumdb -U $DB_USER -d $DB_NAME
  2. Log Management
    • Regular log rotation
    • Log analysis
    • Error monitoring
    • Performance tracking
  3. Updates
    • Regular security updates
    • Feature updates
    • Dependency updates
    • Configuration review