MCP Server

Estella 编辑器内置 MCP（Model Context Protocol） 桥接器，允许 Claude 等 AI 助手实时读取和修改你的场景。MCP 服务器将 MCP 工具调用转换为对运行中编辑器的 HTTP 请求。

前提条件

配置你的 AI 客户端使用 MCP 服务器。无需额外安装步骤——npx 直接从 GitHub 获取。

在项目根目录的 .mcp.json 中添加：

{
  "mcpServers": {
    "estella-editor": {
      "command": "npx",
      "args": ["-y", "github:esengine/estella-mcp-server"]
    }
  }
}

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "estella-editor": {
      "command": "npx",
      "args": ["-y", "github:esengine/estella-mcp-server"]
    }
  }
}

在项目根目录的 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "estella-editor": {
      "command": "npx",
      "args": ["-y", "github:esengine/estella-mcp-server"]
    }
  }
}

在 Estella 编辑器中打开项目。MCP 桥接器会自动在 ~/.esengine/bridge-<port>.json 注册，MCP 服务器启动时通过此文件发现编辑器。

AI 客户端 ←→ MCP Server (stdio) ←→ HTTP Bridge ←→ Estella 编辑器

一次工具调用即可创建完整配置的 UI 控件层级。实体自动挂载到 Canvas 下。

工具	说明
`create_text`	创建文本标签，支持 content、fontSize、color、align
`create_image`	创建图片元素，支持 tint color 和尺寸
`create_panel`	创建带背景和遮罩的面板
`create_button`	创建带背景和交互的按钮
`create_input_field`	创建文本输入框，支持 placeholder 和初始值
`create_toggle`	创建开关/复选框
`create_slider`	创建带填充条和手柄的滑块
`create_progress_bar`	创建带填充的进度条
`create_scroll_view`	创建可滚动容器
`create_dropdown`	创建带选项的下拉菜单

工具	说明
`capture_editor`	截取编辑器截图（整个窗口或指定面板）
`capture_diff`	逐像素比较两张截图

配置完成后，你可以这样向 AI 助手提问：

桥接服务器绑定在 127.0.0.1。如果使用了代理，确保 localhost 流量不经过代理：

curl --noproxy '*' http://127.0.0.1:<port>/health