# 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:**
   ```bash
   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:**
   ```bash
   pip install -r requirements.txt
   pip install -e .
   ```

2. **Start services:**
   
   In separate terminals:
   ```bash
   # 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:

```yaml
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
```bash
pytest tests/
```

### Code Formatting
```bash
black corporate_lxp_mcp/
isort corporate_lxp_mcp/
```

## Environment Variables

Create a `.env` file:

```bash
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