> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arclio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Enterprise

> Administrative dashboard for managing MCP servers with RBAC

## 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**

```bash theme={null}
git clone git@github.com:Rizz-Buzz/mcp-enterprise.git
cd mcp-enterprise
```

2. **Set Up Environment Variables**

```bash theme={null}
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.

3. **Install Dependencies and Initialize Database**

```bash theme={null}
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:

```bash theme={null}
# 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](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`:

```bash theme={null}
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:

```json theme={null}
{
  "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**
   ```bash theme={null}
   # 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**
   ```bash theme={null}
   # 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