Custom AI View

io.github.ccustomai由 GitHub 账号 ccustomai 发布v1.14.0更新于 Oct 24, 2026

See any site as it looks on a real iPhone, iPad or MacBook — and drive that window over MCP.

已验证STDIO仅桌面浏览器自动化开发者工具

概览

AI 生成的概览

一款桌面应用,可在像素级精确的 iPhone、iPad、Android 和 MacBook 外框中显示网站,并通过 MCP 把这个实时窗口交给 AI 助手操作。

可以做什么
在指定设备外框中打开网址,切换设备而不丢失页面,并提供以点、像素和毫米表示的设备尺寸目录,以及保留单页应用状态的刷新和后退。按选择器或可见文字查找元素,执行点击、输入、按键,滚动页面或页面内的滚动区域。检查标记、计算样式、盒模型和祖先层级,逐层遍历 DOM,并读取页面控制台输出和浏览器自身消息。截取实时窗口画面,录制屏幕(可固定时长或不限时长),把截图、标记、控制台和选区收集到按站点归档的同一文件夹。编辑实时页面且改动在刷新后仍生效,列出当前生效的编辑并逐项或全部还原。查看当前打开的地址、设备、视口和选区,并查看已捕获的内容库。
适用场景
适合让助手以真实手机、平板或笔记本外框的样子查看并操作网站——检查响应式布局、测试本地开发服务器,或在你自己已登录的会话中调试页面。
运行要求
作为本地桌面应用运行于 Windows 或 macOS(也有 VS Code 扩展),需要已安装 Chrome 或 Edge。MCP 服务器使用 stdio,通过 node 指向随附的服务器脚本启动;若应用未运行,它会自行启动。macOS 上应用为临时签名,首次启动需右键打开或清除隔离属性。
安装前请注意
应用会运行本地反向代理,剥离 X-Frame-Options 和 CSP、改写媒体查询与安全区数值,并重命名 __Host- cookie 以保留登录状态——应仅用于自己的站点,而非任意第三方浏览。截图、录屏、日志和页面代码会写入桌面下 Custom AI View 文件夹。工具可以点击、输入、编辑实时页面并更改设备状态,助手可能改动你正在处理的内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Custom AI View,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Custom AI View

See any website the way it looks on a real phone — and let an AI agent see it too.

A real browser inside pixel-accurate device frames: iPhone, iPad, Android, MacBook. Ships as a Windows app, a Mac app and a VS Code extension, with an MCP server so your AI assistant looks at the same window you do, over the Model Context Protocol.

If you have ever wanted to view a site as on mobile, preview responsive design on a real device frame, or give an AI agent eyes on your own browser window — that is what this is.

ccustom.ai/view · by Custom AI

[An element picked on the phone, revealed in the code]


Why this exists

Chrome's device toolbar resizes a viewport. It does not give you a phone, and it does not give an agent anything to look at.

Custom AI View does three things nothing free does together:

  • It photographs the window you are actually looking at — your login session, your scroll position, your unsaved input — and hands the picture to an AI agent over MCP. Not a re-render in a clean profile: the screen you can see.
  • It shows sites that refuse to be framed. A local reverse proxy strips X-Frame-Options and CSP, rewrites @media (hover) and env(safe-area-inset-*), renames __Host- cookies so logins survive, and terminates the self-signed TLS your dev server uses.
  • It is physically true. Bodies, screens and corner radii come from published dimensions in millimetres; bezels are derived from body-minus-panel. Actual size 1:1 measures your monitor over EDID and draws the device at life size — hold a real iPhone against the glass and it matches.

What an agent can do with it

custom_ai_view_open        open a URL on a given devicecustom_ai_view_wait        wait for an element, or for loading to finishcustom_ai_view_screenshot  the live window — and it says so when it is notcustom_ai_view_find        elements by selector or visible text, with real visibilitycustom_ai_view_click       tap somethingcustom_ai_view_type        type into a field, optionally submitting on Entercustom_ai_view_key         Enter, Escape, Tab, arrowscustom_ai_view_scroll      the page, or one scroller inside itcustom_ai_view_inspect     markup, computed styles, box, ancestrycustom_ai_view_tree        walk the DOM a level at a timecustom_ai_view_edit        change the live page; survives reload; revert undoes itcustom_ai_view_console     page output *and* the browser's own messages, with agescustom_ai_view_back        go back without losing SPA statecustom_ai_view_record      screen recording with no fixed lengthcustom_ai_view_record_clip a clip of fixed length, when the length is knowncustom_ai_view_collect     screenshot + markup + console + selection, in one foldercustom_ai_view_state       what is open now: address, device, viewport, selectioncustom_ai_view_set_device  change the device without losing the pagecustom_ai_view_devices     the catalogue, with points, pixels and millimetrescustom_ai_view_reload      normal, hard, or clearing the cache firstcustom_ai_view_edits       every live edit currently in forcecustom_ai_view_revert      put one of them back, or all of themcustom_ai_view_library     what has been captured, filed by site

Every tool takes a window argument, so a phone and an iPad can be driven side by side.

Install

Windows app — download CustomAIView.exe from Releases, run it, and pin it. No dependencies; it needs Chrome or Edge installed. To put the branded shortcut on your desktop: node scripts/make-launcher.js.

Mac app — download CustomAIView-macos-arm64.zip (Apple silicon) or -x64.zip (Intel) from the same page, unzip it into /Applications and open it. It needs Chrome or Edge installed. The bundle is signed ad-hoc rather than notarised, so the first launch is right-click → Open — or, once:

xattr -dr com.apple.quarantine "/Applications/Custom AI View.app"

VS Code extension — download the .vsix from Releases and code --install-extension custom-ai-view-<version>.vsix, then reload the window.

For your AI assistant — the server speaks MCP over stdio, so any MCP client takes the same block:

json
{  "mcpServers": {    "custom-ai-view": { "command": "node", "args": ["<path>/mcp/server.js"] }  }}

In VS Code, Custom AI View: Show MCP Server Setup hands you that block with the path already filled in. The MCP server starts the app itself if it is not running, so an agent never has to ask a human to open something first.

Build from source

node scripts/build-exe.js       # dist/CustomAIView(.exe)  (Node SEA, ~82 MB)node scripts/build-mac-app.js   # dist/Custom AI View.app + a zip   (macOS only)node scripts/make-launcher.js   # desktop shortcut with the icon    (Windows only)npm run package                 # the .vsix

The single executable is a copy of the node binary it was built with, so a Mac build needs a Mac. .github/workflows/release.yml builds all three on a tag — Apple silicon, Intel and Windows — and attaches them to the release.

[MacBook Pro 14-inch frame: black glass, the notch cut into the macOS menu bar, and the deck below the lid]

A MacBook lid is one sheet of black glass with a hairline of anodised edge, its chin three times its forehead, and its notch cut into the menu bar — where a browser window never reaches, so it is never a black rectangle over your site.

What it looks like

[The start page, listing the dev servers found on this machine]

Dev servers are not guessed from a list of usual ports. The app asks the operating system what is listening, then asks each port whether it serves pages — and shows the site's own title and icon. The one on 8899 above is on no list of usual ports.

[iPhone 16 Pro frame showing a live site][iPad Pro 11-inch frame showing the same site]
iPhone 16 Pro — 402 × 874 pt, @3x, 67 × 145 mm, safe area 62/34iPad Pro 11" (M4) — the same engine, the same proxy, the same session

Notable details

  • The home indicator floats over the page, as on a real phone — nothing is carved out of the viewport. env(safe-area-inset-bottom) still reports 34.
  • A finger, not an arrow. On phones and tablets the cursor is a 44 px circle: the contact patch a fingertip actually covers, which is what decides whether a control is reachable.
  • Momentum matches iOS (0.967 per frame), horizontal strips drag, and text does not select while you swipe.
  • Captures are filed by site under Desktop → Custom AI View, with screenshots/, recordings/, logs/ and code/, plus a one-button "save everything about this page".
  • When a page leaves for another app — itms-appss:// and friends — the frame says so instead of going white.

Licence

Proprietary. See LICENSE. You may use it; you may not redistribute it, fork it, rebrand it, or present any part of it as your own. "Custom AI", "Custom AI View" and the C mark are trademarks of Custom AI.

For permission: [email protected]


Read this in Russian · © 2026 Custom AI · https://ccustom.ai

来源:README.md,提交 8572656

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.14.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。