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 optionsget_employee- Get employee by ID or emailcreate_employee- Add new employeeupdate_employee- Update employee informationdelete_employee- Remove employeeget_employee_training- Get training assignmentsget_employee_skills- Get skill assessmentsget_department_employees- List department employeesupdate_training_progress- Track training completionlist_departments- List all departmentslist_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
