Maya MCP Server

# Technology Stack & Build System ## Core Technologies - **Python 3.8+**: Primary language for server implementation - **MCP SDK**: Model Context Protocol implementation - **AsyncIO**: Asynchronous programming for server operations - **Autodesk Maya API**: Maya integration via command port and Python API ## Key Dependencies ### Runtime Dependencies - `mcp>=1.0.0`: Model Context Protocol SDK - `pydantic>=2.0.0`: Data validation and serialization - `aiohttp>=3.8.0`: Async HTTP client/server - `websockets>=11.0.0`: WebSocket communication - `pyyaml>=6.0`: Configuration file parsing - `requests>=2.28.0`: HTTP client for Maya communication ### Development Dependencies - `pytest>=7.0.0`: Testing framework - `pytest-asyncio>=0.21.0`: Async testing support - `black>=23.0.0`: Code formatting - `flake8>=6.0.0`: Linting - `mypy>=1.0.0`: Type checking ## Project Structure ``` src/ # Main source code ├── server.py # Entry point and CLI ├── mcp_server.py # MCP protocol implementation ├── maya_bridge.py # Maya communication layer ├── models.py # Data models and tool definitions └── config.py # Configuration management plug-ins/ # Maya plugin └── mayamcp.py # Auto-loading Maya plugin tests/ # Test suite bin/ # Executable scripts config.yaml # Default configuration ``` ## Common Commands ### Development ```bash # Install dependencies pip install -r requirements.txt # Run server in debug mode python src/server.py --debug # Run tests pytest tests/ # Format code black src/ tests/ # Type checking mypy src/ ``` ### Production ```bash # Install via NPX (recommended) npx maya-mcp-server # Manual installation python src/server.py --host localhost --port 8765 ``` ### Maya Plugin Installation ```bash # Windows copy plug-ins/mayamcp.py "%USERPROFILE%\Documents\maya\plug-ins\" # macOS/Linux cp plug-ins/mayamcp.py ~/Library/Preferences/Autodesk/maya/plug-ins/ ``` ## Configuration Configuration is loaded from: 1. `config.yaml` (default) 2. Environment variables (prefix: `MAYA_MCP_`) 3. Command line arguments (highest priority) Key configuration options: - `host/port`: Server binding - `maya_port`: Maya command port (default: 7022) - `allowed_commands/blocked_commands`: Security settings - `debug/log_level`: Logging configuration