
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.
概览
一款桌面应用,可在像素级精确的 iPhone、iPad、Android 和 MacBook 外框中显示网站,并通过 MCP 把这个实时窗口交给 AI 助手操作。
- 可以做什么
- 在指定设备外框中打开网址,切换设备而不丢失页面,并提供以点、像素和毫米表示的设备尺寸目录,以及保留单页应用状态的刷新和后退。按选择器或可见文字查找元素,执行点击、输入、按键,滚动页面或页面内的滚动区域。检查标记、计算样式、盒模型和祖先层级,逐层遍历 DOM,并读取页面控制台输出和浏览器自身消息。截取实时窗口画面,录制屏幕(可固定时长或不限时长),把截图、标记、控制台和选区收集到按站点归档的同一文件夹。编辑实时页面且改动在刷新后仍生效,列出当前生效的编辑并逐项或全部还原。查看当前打开的地址、设备、视口和选区,并查看已捕获的内容库。
- 适用场景
- 适合让助手以真实手机、平板或笔记本外框的样子查看并操作网站——检查响应式布局、测试本地开发服务器,或在你自己已登录的会话中调试页面。
- 运行要求
- 作为本地桌面应用运行于 Windows 或 macOS(也有 VS Code 扩展),需要已安装 Chrome 或 Edge。MCP 服务器使用 stdio,通过 node 指向随附的服务器脚本启动;若应用未运行,它会自行启动。macOS 上应用为临时签名,首次启动需右键打开或清除隔离属性。
安装
在 SourceWeft 中
- 打开 控制台中的 Custom AI View,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
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-Optionsand CSP, rewrites@media (hover)andenv(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
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:
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:
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
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.
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.
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/andcode/, 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版本历史
1- v1.14.0最新Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。