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)

Start all services:
```
docker-compose up -d
```
Access services:
- API Server: http://localhost:9001
- Registry: http://localhost:9000
- API Docs: http://localhost:9001/docs

Manual Installation

Install dependencies:

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

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