Corporate LXP MCP Platform

A comprehensive Learning Experience Platform (LXP) for corporate environments with MCP (Model Context Protocol) integration. This platform provides user management, training programs, skill assessments, and department management for corporate employees.

Features

Core Functionality

• Employee Management: Complete CRUD operations for corporate employees
• Department Management: Organizational structure management
• Training Programs: Corporate training assignment and tracking
• Skill Assessments: Employee skill evaluation and gap analysis
• MCP Integration: Seamless integration with agentic frameworks

MCP Tools Available

• list_employees - List employees with filtering options
• get_employee - Get employee by ID or email
• create_employee - Add new employee
• update_employee - Update employee information
• delete_employee - Remove employee
• get_employee_training - Get training assignments
• get_employee_skills - Get skill assessments
• get_department_employees - List department employees
• update_training_progress - Track training completion
• list_departments - List all departments
• list_training_programs - Available training programs

Architecture

The solution follows SOLID principles with clear separation of concerns:

corporate_lxp_mcp/
├── models/          # Pydantic data models
├── services/        # Business logic layer
├── api/            # FastAPI REST endpoints
├── mcp/            # MCP server implementation
├── registry/       # MCP registry for discovery
├── config/         # Configuration management
└── tests/          # Unit tests

Quick Start

Using Docker (Recommended)

1. Start all services:

   docker-compose up -d
   

2. Access services:

   • API Server: http://localhost:9001
   • Registry: http://localhost:9000
   • API Docs: http://localhost:9001/docs

Manual Installation

1. Install dependencies:

   pip install -r requirements.txt
   pip install -e .
   

2. Start services:

   In separate terminals:

   # Start registry
   corporate-lxp-registry
   
   # Start API server
   corporate-lxp-api
   
   # Start MCP server
   corporate-lxp-mcp
   

MCP Integration

Configuration for Agentic Frameworks

Add this to your MCP configuration:

mcpServers:
  corporate-lxp:
    command: "python"
    args: ["-m", "corporate_lxp_mcp.mcp_server.main"]
    env:
      PYTHONPATH: "."

Available Tools

The MCP server provides tools for managing corporate learners:

• Employee management (CRUD operations)
• Training assignment and progress tracking
• Skill assessment management
• Department-based queries
• Search and filtering capabilities

API Documentation

Once the API server is running, visit:

• Swagger UI: http://localhost:9001/docs
• ReDoc: http://localhost:9001/redoc

Mock Data

The platform comes pre-loaded with:

• 5 departments (Engineering, Sales, Marketing, HR, Finance, Operations)
• Sample employees with different roles and departments
• Training programs (onboarding, leadership, technical, compliance)
• Skill categories and assessments

Development

Code Structure

• Models: Pydantic models for data validation
• Services: Business logic following SOLID principles
• API: FastAPI endpoints with proper error handling
• MCP: Model Context Protocol server implementation
• Registry: Service discovery and configuration management

Running Tests

pytest tests/

Code Formatting

black corporate_lxp_mcp/
isort corporate_lxp_mcp/

Environment Variables

Create a .env file:

CORPORATE_LXP_API_HOST=0.0.0.0
CORPORATE_LXP_API_PORT=8001
CORPORATE_LXP_REGISTRY_PORT=8000
CORPORATE_LXP_LOG_LEVEL=INFO
CORPORATE_LXP_DEBUG=false

License

MIT License - see LICENSE file for details.

Support

For issues and questions:

• Create an issue in the repository
• Check the API documentation
• Review the MCP configuration examples