MultiFlexi MCP Server

MultiFlexi MCP Server

MCP (Model Context Protocol) Server for MultiFlexi API integration. This server provides tools and resources for interacting with MultiFlexi applications, jobs, companies, users, and run templates.

Features

• Applications: List, retrieve, and manage MultiFlexi applications
• Jobs: Create, retrieve, and monitor job execution
• Companies: Manage company data and configurations
• Users: Access user information and profiles
• Run Templates: Create and update execution templates
• GDPR Compliance: Request and manage data exports
• Authentication: Support for basic authentication
• Error Handling: Comprehensive error handling and logging

Installation

Using pip

pip install multiflexi-mcp-server

From source

git clone https://github.com/VitexSoftware/multiflexi-mcp-server.git
cd multiflexi-mcp-server
pip install -e .

Configuration

The server can be configured using environment variables:

Required Configuration

• MULTIFLEXI_HOST: MultiFlexi API host URL (default: demo server)

Optional Configuration

• MULTIFLEXI_USERNAME: Username for basic authentication
• MULTIFLEXI_PASSWORD: Password for basic authentication
• MULTIFLEXI_VERIFY_SSL: Whether to verify SSL certificates (default: true)
• MULTIFLEXI_TIMEOUT: Request timeout in seconds (default: 30)
• MULTIFLEXI_MAX_RETRIES: Maximum number of retries (default: 3)
• MULTIFLEXI_DEBUG: Enable debug logging (default: false)

Example Configuration

export MULTIFLEXI_HOST="https://your-multiflexi-instance.com"
export MULTIFLEXI_USERNAME="your-username"
export MULTIFLEXI_PASSWORD="your-password"
export MULTIFLEXI_VERIFY_SSL="true"
export MULTIFLEXI_DEBUG="false"

Usage

Running the Server

multiflexi-mcp-server

Claude Desktop Integration

Add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "multiflexi": {
      "command": "multiflexi-mcp-server",
      "env": {
        "MULTIFLEXI_HOST": "https://your-multiflexi-instance.com",
        "MULTIFLEXI_USERNAME": "your-username",
        "MULTIFLEXI_PASSWORD": "your-password"
      }
    }
  }
}

Using with MCP Clients

The server provides the following resources:

• multiflexi://apps - List of applications
• multiflexi://jobs - List of jobs
• multiflexi://companies - List of companies
• multiflexi://users - List of users
• multiflexi://runtemplates - List of run templates

Available Tools

Application Management

• get_app - Get application by ID
• get_apps - List all applications (via resources)

Job Management

• get_job - Get job by ID
• create_job - Create a new job
• get_job_status - Get job execution status
• get_jobs - List all jobs (via resources)

Company Management

• get_company - Get company by ID
• get_companies - List all companies (via resources)

User Management

• get_user - Get user by ID
• get_users - List all users (via resources)

Run Template Management

• get_runtemplate - Get run template by ID
• update_runtemplate - Update run template
• get_runtemplates - List all templates (via resources)

GDPR Compliance

• request_data_export - Request data export
• get_export_status - Check export status

Example Tool Usage

{
  "tool": "get_app",
  "arguments": {
    "app_id": 123,
    "format": "json"
  }
}

{
  "tool": "create_job",
  "arguments": {
    "app_id": 123,
    "company_id": 456,
    "job_data": {
      "name": "Data Processing Job",
      "description": "Process daily data",
      "schedule": "0 2 * * *"
    }
  }
}

{
  "tool": "request_data_export",
  "arguments": {
    "export_type": "personal_data",
    "format": "json"
  }
}

Development

Prerequisites

• Python 3.9+
• pip
• virtualenv (recommended)

Setup Development Environment

git clone https://github.com/VitexSoftware/multiflexi-mcp-server.git
cd multiflexi-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e ".[dev]"

Running Tests

pytest

Code Formatting

# Format code
black src/ tests/

# Sort imports
isort src/ tests/

# Type checking
mypy src/

# Linting
ruff src/ tests/

API Documentation

This server integrates with the MultiFlexi API. For detailed API documentation, refer to:

• MultiFlexi API Documentation
• OpenAPI Specification

Error Handling

The server provides comprehensive error handling:

• API Errors: Formatted with status codes and detailed messages
• Authentication Errors: Clear authentication failure messages
• Validation Errors: Input validation with descriptive errors
• Network Errors: Timeout and connection error handling

All errors are returned in a consistent JSON format:

{
  "error": true,
  "operation": "get_app",
  "status": 404,
  "reason": "Not Found",
  "details": {
    "message": "Application with ID 123 not found"
  }
}

Security Considerations

• Authentication: Use environment variables for credentials
• SSL Verification: Enable SSL verification in production
• Network Security: Ensure secure network connections
• Data Privacy: Handle GDPR exports with appropriate security

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Run the test suite
6. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Issues: GitHub Issues
• Documentation: GitHub Wiki
• Email: [email protected]

Changelog

v0.1.0 (Initial Release)

• Basic MCP server implementation
• MultiFlexi API integration
• Application, job, company, user, and template management
• GDPR compliance features
• Comprehensive error handling
• Environment-based configuration