lightfast-mcp

---
description: Lightfast MCP project architecture, structure, and file organization patterns
globs: 
alwaysApply: true
---
# Project Architecture

## Core Structure
```
src/lightfast_mcp/          # Core MCP server implementations
├── core/                   # Base classes (BaseServer, ServerConfig), shared server utilities
├── servers/                # MCP server implementations
│   ├── blender/            # Blender MCP server
│   │   ├── server.py
│   │   └── __init__.py
│   ├── mock/               # Mock MCP server for testing
│   │   ├── server.py
│   │   ├── tools.py
│   │   └── __init__.py
│   ├── blender_mcp_server.py  # Blender server entry point script
│   └── mock_mcp_server.py     # Mock server entry point script
└── utils/                  # Shared utilities for MCP servers (e.g., logging)

src/tools/                  # Development and orchestration tools
├── orchestration/          # Multi-server orchestration (ServerOrchestrator, ServerRegistry, ConfigLoader)
├── ai/                     # AI integration tools (ConversationClient, AI providers)
├── common/                 # Common utilities specific to the tools package
└── __init__.py             # Tools package exports
```

## Entry Points
- `lightfast-mcp-orchestrator`: Main CLI for orchestrating multiple servers
- `lightfast-blender-server`: Direct Blender server entry point
- `lightfast-mock-server`: Direct mock server entry point

## File Patterns
- `servers/{app}_mcp_server.py`: Entry point scripts
- `servers/{app}/server.py`: Main server implementation  
- `servers/{app}/tools.py`: Tool implementations
- `servers/{app}/resources.py`: Resource implementations (if applicable)
- `config/servers.yaml`: Server configuration
- `tests/unit/test_{module}.py`: Unit tests
- `tests/integration/test_{feature}.py`: Integration tests
- `tests/e2e/test_{workflow}.py`: End-to-end tests

## Configuration Files
- `.cursor/mcp.json`: Cursor MCP integration config
- `pyproject.toml`: Project configuration and dependencies
- `config/servers.yaml`: Server configuration