Lensstudio MCP

镜头工作室MCP服务器

连接的MCP（模型上下文协议）服务器 任何AI代理 到 镜头工作室 实时。告诉你的AI构建一个AR镜头，并观看它的实时发生。

无需插件，可与Lens Studio 5.15+的内置MCP端点配合使用。

兼容： 克劳德桌面版, 克劳德代码, 光标, 帆板运动, VS代码副本, OpenAI代理，以及任何兼容MCP的客户端。

______________________________________________________________________

运作原理

AI Agent    lens-studio-mcp    Lens Studio (port 50050)

Lens Studio 5.15+附带了内置的HTTP MCP服务器，位于 localhost:50050/mcp。此服务器是一个代理：

1. 发现Lens Studio API的所有工具
2. 使用友好的包装器将它们注册为MCP工具
3. 通过HTTP转发工具调用并处理身份验证
4. 增加 81高级工具 用于面部滤镜、材质、动画、粒子、脚本等

______________________________________________________________________

先决条件

• Python 3.10+
• 镜头工作室5.15+ （在同一台机器上运行）
• 推荐macOS（UI自动化工具仅限macOS，但所有API工具都可以跨平台工作）

______________________________________________________________________

安装

步骤1：克隆仓库

git clone https://github.com/superdwayne/lensstudio-mcp.git
cd lensstudio-mcp

步骤2：创建虚拟环境并安装依赖项

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

步骤3：验证服务器是否运行

python server.py --help

您应该看到可用的运输选项(stdio, sse, streamable-http).

______________________________________________________________________

连接到您的AI代理

选项A:Claude Desktop（自动安装程序）

运行附带的安装程序脚本——它会自动添加 lens-studio 到您的Claude Desktop配置：

python install_claude_config.py

然后 重新启动克劳德桌面。Lens Studio MCP服务器将出现在您可用的工具中。

选项B：克劳德桌面（手动）

打开您的Claude Desktop配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加 lens-studio 进入下 mcpServers:

{
  "mcpServers": {
    "lens-studio": {
      "command": "/FULL/PATH/TO/lensstudio-mcp/.venv/bin/python",
      "args": [
        "/FULL/PATH/TO/lensstudio-mcp/server.py",
        "--transport", "stdio"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

替换 /FULL/PATH/TO/lensstudio-mcp 使用克隆仓库的实际路径。

保存后重新启动Claude Desktop。

选项C：克劳德代码

添加到您的项目 .mcp.json 或运行：

claude mcp add lens-studio -- /FULL/PATH/TO/lensstudio-mcp/.venv/bin/python /FULL/PATH/TO/lensstudio-mcp/server.py --transport stdio

或者创建一个 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "lens-studio": {
      "command": "/FULL/PATH/TO/lensstudio-mcp/.venv/bin/python",
      "args": [
        "/FULL/PATH/TO/lensstudio-mcp/server.py",
        "--transport", "stdio"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

选项D：光标

创建 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "lens-studio": {
      "command": "/FULL/PATH/TO/lensstudio-mcp/.venv/bin/python",
      "args": [
        "/FULL/PATH/TO/lensstudio-mcp/server.py",
        "--transport", "stdio"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

选项E：风帆

添加 .windsurf/mcp.json 或你的项目 .mcp.json:

{
  "mcpServers": {
    "lens-studio": {
      "command": "/FULL/PATH/TO/lensstudio-mcp/.venv/bin/python",
      "args": [
        "/FULL/PATH/TO/lensstudio-mcp/server.py",
        "--transport", "stdio"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

选项F:SSE传输（远程/web客户端）

对于通过HTTP而不是stdio连接的客户端：

source .venv/bin/activate
python server.py --transport sse --port 8000

然后向您的客户指出 http://localhost:8000/sse.

选项G：流式HTTP传输

source .venv/bin/activate
python server.py --transport streamable-http --port 8000

______________________________________________________________________

首映

1. Open Lens Studio 5.15+ 并打开或创建项目
2. 启动您的AI代理 （克劳德桌面、光标等）
3. 首次连接时，Lens Studio会显示 权限弹出窗口 --点击 允许
4. 身份验证令牌缓存在 ~/.lens_mcp_token.json 并自动重复使用
5. 开始提示你的AI！

示例提示

"Create a face filter with a red clown nose and cat ears"

"Add a sparkle particle effect to both hands"

"Apply a vintage color grading effect to the camera"

"Search for a crown 3D model and import it"

"Make the nose scale up when I open my mouth"

______________________________________________________________________

可选：Sketchfab 3D模型搜索

启用从以下位置搜索和导入3D模型 Sketchfab:

1. 在获取免费API令牌 sketchfab.com/settings/password
2. 将令牌添加到MCP配置中 env 块：

{
  "mcpServers": {
    "lens-studio": {
      "command": "/FULL/PATH/TO/lensstudio-mcp/.venv/bin/python",
      "args": [
        "/FULL/PATH/TO/lensstudio-mcp/server.py",
        "--transport", "stdio"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "SKETCHFAB_API_TOKEN": "your_token_here"
      }
    }
  }
}

______________________________________________________________________

可用工具（81）

连接和状态

场景管理

材料和颜色

人脸追踪

手部追踪

身体跟踪

世界追踪

动画

粒子

分割

脚本编写

音频

后处理

镜片配方

3D模型库（Sketchfab）

macOS UI自动化（回退）

对于无法通过API进行的操作： ui_activate, ui_menu_click, ui_new_project, ui_save_project, ui_open_project, ui_preview, ui_keystroke, ui_type_text, ui_import_asset, ui_export_lens, ui_add_object, ui_dump_menus, ui_list_buttons, ui_click_button, ui_request_permissions

______________________________________________________________________

环境变量

______________________________________________________________________

故障排除

______________________________________________________________________

运行测试

source .venv/bin/activate
python -m pytest smoke_test.py -v

所有160个测试都在模拟Lens Studio服务器上运行，不需要真正的Lens Studio实例。

______________________________________________________________________

安全

• Lens Studio的MCP服务器绑定到 localhost 仅--无法从网络访问
• 身份验证令牌存储在本地 ~/.lens_mcp_token.json
• SSE/HTTP传输绑定到 127.0.0.1 默认情况下
• Sketchfab API令牌是从环境变量中读取的，从不硬编码

许可证

麻省理工学院