lightfast-mcp

--- description: Development workflow commands and tooling for lightfast-mcp globs: alwaysApply: true --- # Development Workflow ## Tool Stack - Use `uv` for dependency management and running commands - Use `taskipy` for common development tasks - Use `nox` for comprehensive testing across Python versions - Use `ruff` for linting and formatting ## Common Commands ### Setup & Development ```bash # Setup uv sync --extra dev # Development uv run task lint # Run linting uv run task format # Format code uv run task test_fast # Quick tests uv run task demo # Test working system ``` ### Server Management ```bash uv run lightfast-mcp-orchestrator init # Create sample config uv run lightfast-mcp-orchestrator list # List available servers uv run lightfast-mcp-orchestrator start # Start servers interactively uv run lightfast-mcp-orchestrator ai # Start AI client # Individual Servers uv run lightfast-blender-server # Start Blender server directly uv run lightfast-mock-server # Start mock server directly ``` ### Testing Commands ```bash # Fast feedback nox -s test_fast # Fast tests (excluding slow) # Full test suite nox # Specific test types nox -s test_e2e # End-to-end tests nox -s test_integration # Integration tests nox -s test_coverage # Tests with coverage nox -s test-3.13 # Python 3.13 tests nox -s typecheck # MyPy type checking nox -s verify_system # System verification ``` ## Development Guidelines - Use async/await patterns throughout for better performance - Prefer configuration over hardcoded values - Include appropriate tests for new functionality - Follow the existing project patterns and conventions