lens-studio-mcp

# lens-studio-mcp An MCP (Model Context Protocol) server that connects **any AI coding agent** to **Lens Studio** in real-time. Tell your AI to build an AR lens and watch it happen live. No plugins required — works with Lens Studio 5.15+'s built-in MCP endpoint. Compatible with: **Claude Desktop**, **Claude Code**, **Cursor**, **Windsurf**, **VS Code Copilot**, **OpenAI agents**, and any MCP-compatible client. ## How It Works ``` AI Agent ←─ MCP (stdio/SSE/HTTP) ─→ lens-studio-mcp ←─ HTTP JSON-RPC ─→ Lens Studio (port 50050) ``` Lens Studio 5.15+ ships with a built-in HTTP MCP server at `localhost:50050/mcp`. This package is a thin proxy that: 1. Discovers all tools from Lens Studio's API 2. Registers them as MCP tools with friendly wrappers 3. Forwards tool calls via HTTP and handles authentication 4. Adds convenience tools for face filters, materials, colors, and macOS UI automation ## Installation ### From PyPI (recommended) ```bash pip install lens-studio-mcp ``` ### From source ```bash git clone https://github.com/superdwayne/lens-studio-mcp.git cd lens-studio-mcp pip install -e . ``` ## Quick Start ### 1. Open Lens Studio Launch **Lens Studio 5.15+** and open or create a project. The built-in MCP server starts automatically on port 50050. ### 2. Configure your AI agent Add `lens-studio-mcp` to your editor's MCP configuration: **Windsurf** (`.windsurf/mcp.json` or project `.mcp.json`): ```json { "mcpServers": { "lens-studio": { "command": "lens-studio-mcp", "args": ["--transport", "stdio"] } } } ``` **Claude Desktop** (`claude_desktop_config.json`): ```json { "mcpServers": { "lens-studio": { "command": "lens-studio-mcp", "args": ["--transport", "stdio"] } } } ``` **Cursor** (`.cursor/mcp.json`): ```json { "mcpServers": { "lens-studio": { "command": "lens-studio-mcp", "args": ["--transport", "stdio"] } } } ``` **SSE transport** (for remote/web clients): ```bash lens…