Lasso MCP server
Commit Oct 29, 2026An all-in-one interaction MCP that enables AI clients to search the web, scrape content, manage logged-in sessions, and control desktop applications.
Also known as wangdong233/lasso, lasso-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 29, 2026
- License
- MIT
What is Lasso MCP?
Lasso is an all-in-one interaction MCP that enables AI clients to search the web, scrape content, manage logged-in sessions, and control desktop applications.
Summary generated from the project's README
About Lasso MCP server
Lasso provides a comprehensive interaction layer for AI clients like Claude Code to bridge the gap between chat and the physical or digital world. It enables users to perform web searches, scrape website content, and manage logged-in sessions by reusing local Chrome profiles. This allows the AI to access private data like Jira tasks or GitHub repositories without requiring manual 2FA handling by the agent itself.
Beyond the browser, Lasso extends to desktop automation, allowing the AI to control native applications on macOS, Windows, and Linux through semantic actions. It can manage files, take full-page screenshots, save PDFs, and even download large files using engines like aria2c or yt-dlp. Developers can use it to audit network resources, check console errors, or even fetch raw JSON data directly. The server is designed to be highly efficient, offering specialized extractors for high-frequency sites to reduce token usage by stripping away ads and navigation elements.
Written from the project's README. Every use case is checked against a quote from it.
How to install Lasso MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Lasso MCP in Claude Code
$ claude mcp add lasso -- npx -y lasso-mcpInstall Lasso MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"lasso": {
"command": "npx",
"args": [
"-y",
"lasso-mcp"
]
}
}
}Install Lasso MCP in VS Code
.vscode/mcp.json
{
"servers": {
"lasso": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"lasso-mcp"
]
}
}
}Install Lasso MCP in VS Code CLI
$ code --add-mcp '{"name":"lasso","type":"stdio","command":"npx","args":["-y","lasso-mcp"]}'Install Lasso MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"lasso": {
"command": "npx",
"args": [
"-y",
"lasso-mcp"
]
}
}
}Install Lasso MCP in Codex
$ codex mcp add lasso -- npx -y lasso-mcpInstall Lasso MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.lasso] command = "npx" args = ["-y", "lasso-mcp"]
Install Lasso MCP in Gemini CLI
$ gemini mcp add -s user lasso npx -- -y lasso-mcpInstall Lasso MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"lasso": {
"command": "npx",
"args": [
"-y",
"lasso-mcp"
]
}
}
}Configuration
BRAVE_API_KEYSBROWSERBASE_API_KEYLASSO_ALLOW_CLOUD_BROWSERLASSO_AUTO_HIDE_AFTER_LOGINLASSO_CDP_PORTLASSO_LAUNCH_EXTRA_ARGSLASSO_LAUNCH_LOCALESTEEL_ENDPOINT
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablewangdong233/lasso is public and reachablegithub.com/wangdong233/lasso ↗Pass
- Package names this repository as its sourcelasso-mcp names wangdong233/lasso as sourcenpmjs.com/package/lasso-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-29github.com/wangdong233/lasso ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from lasso-mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubClaude Code 的「全交互对外抓手」—— 搜、抓网页、抓登录态页、控桌面,一句话全包。 牛仔套索,套住任何界面。
给 Claude Code 装一次,以后搜东西、抓网页、抓登录态页、控桌面都是一句话。 每周都要搜几次、抓几篇、点几下桌面 app,又不想为每件事单独装一个工具——这里只装一次,全交给 Claude。
与 media-gen-mcp(图像抓手)双子星:「所有图像操作归一个 MCP」↔「所有外部交互归一个 MCP」。
简体中文 | English
目录
你说一句话,得到什么
| 你说 …… | 你得到 |
|---|---|
| 「搜一下 rust async 生态最新动态」 | 结构化搜索结果(某家临时挂掉自动换下一家,你无感) |
| 「搜最近一周 Claude Code 的更新」(v1.11) | 按 freshness=week 过滤的时效结果——不用往查询词里手写日期 |
| 「claude-code 最新版本号是多少」(v1.16) | 官方 feed 最新条目(发布即推送,不等搜索索引;给一个 RSS/Atom 地址即可) |
| 「抓一下 github.com 首页文字」 | 干净正文(自动剥掉导航 / 广告 / 冗余,省 30–70% 字数;20 多个高频站点走专用抽取器、表格不丢结构——v1.12) |
| 「打开我已登录的 Jira 看看待办」 | 登录态页面快照(复用你本机 Chrome,2FA 你自己解) |
| 「这个链接打不开了,找找存档」 | 互联网档案馆最近一份快照 |
| 「把 Finder 当前窗口的文件列出来」 | 桌面上的窗口和控件列表(语义树,非截图;树被截断会明说 truncated:true——v1.12) |
| 「点一下那个新建文件夹按钮」「在搜索框里输入 XX」(v1.11) | 桌面动作真实执行(AXAPI 语义点击/输入 + 结果验证;canvas/Electron 自动降级坐标点击) |
| 「把这一页截个整页长图」「存成 PDF」 | 落盘的文件路径(不会把一大坨图片数据塞进对话) |
| 「这个页面加载了哪些第三方跟踪」 | 资源列表 + 跟踪域名计数 |
| 「列一下我现在能控的所有窗口和网页」 | 一个统一清单(网页和桌面窗口都在里面) |
| 「把系统深色模式关掉」 | 自动点按 / 输入 / 快捷键(带结果验证,做完了会确认) |
| 「直接取这个 JSON 接口的返回值」 | 原始字节(最快最省) |
| 「这个站好像有点反爬,试试看」 | browse_headless 自带反检测(过基础 bot 检测),很多站点直接能抓,无需配置 |
| 「这个站有 Cloudflare 我抓不动」 | 云端 Chrome 反爬——Steel 自托管(免费) 或 browserbase/stagehand(付费,默认关) |
| 「Lasso 现在配好了吗?」 | 一份健康自检报告(告诉你哪里没配好) |
你不用记任何能力名,直接说你想干什么,Claude 自己挑最合适的方式完成。
💰 费用一览
Lasso 本体完全免费 + MIT 开源。每一项能力到底要不要花钱,一张表说清:
| 能力 | 费用 | 说明 |
|---|---|---|
| Lasso 本体(MCP server + 全部核心能力) | ✅ 免费 | MIT 开源,永远免费 |
| 搜索(机器智谱 MCP 复用 + Brave) | ✅ 通常零配置 | 机器已配智谱 web-search-prime MCP 即自动复用(主路径,无需任何搜索 key);Brave 为可选付费计划含 $5/月额度(2026-02 起免费档取消);Lasso 还自带免费实搜兜底,一家不配也有搜索。v1.17 起 Lasso 不再支持自有智谱直连 key(ZHIPU_API_KEY 已退役) |
| 抓公开页 / 截图 / PDF / 网络审计 / 抓原始字节 / 本地私有搜索(v1.17:历史+文件) | ✅ 免费 | 本地运行,无 key 无付费 |
| 抓登录态页面(复用本机 Chrome) | ✅ 免费 | 本地运行,无 key 无付费 |
| 控桌面(macOS / Windows / Linux) | ✅ 免费 | 本地构建运行,仅需系统授权;可选 Apple 开发者账号 $99/年做签名持久授权(不签名也能用,只是每次重授权) |
| 云浏览器 · 自托管 Steel(v1.6 新) | ✅ 免费 | 本地 Docker 跑 Steel(Apache-2.0 开源),零 per-session 费 + cookie 不出本地;需 LASSO_ALLOW_CLOUD_BROWSER=true + STEEL_ENDPOINT=http://localhost:3000 |
| 云浏览器 · 托管型(browserbase / stagehand) | ⚠️ 付费,默认关 | browserbase 试用后按量付费;stagehand 是程序化实验通道(无 MCP 工具入口);不配不花钱 |
browse_headless 反检测(v1.5 新) |
✅ 免费 | 默认注入 16 路反检测(UA / webdriver / webgl 等),很多基础 bot 检测直接过 |
一句话总结:只要不开托管型云浏览器(browserbase/stagehand),Lasso 全程 0 成本——搜索有免费额度够日常用,Steel 自托管也是免费的。
60 秒上手
30 秒|一行接入(零配置)
claude mcp add lasso -- npx -y lasso-mcp
重启 Claude Code → 输入 /mcp → 看到 lasso ✓ Connected 就装好了。安装命令不带任何 key——下一档再说配置。
30 秒|不配任何东西,已经能干这些
装完就能用,一个 key 都不用配(这是第一档:零配置):
- 抓任何公开网页的文字、转成干净正文
- 截整页长图、存 PDF,返回文件路径
- 看一个页面加载了哪些第三方跟踪
- 直接取 JSON 接口或文件的原始返回
- 控制 macOS 原生 app(Finder / Mail / 系统设置等,需在系统设置里勾一下授权)
💡 搜索默认零配置可用:如果你机器的
~/.claude.json已经配过智谱web-search-primeMCP,Lasso 启动时自动检测复用——搜索直接能用,不需要配任何搜索 key(v1.17 起这是唯一受支持的智谱接入方式)。跑lasso doctor看#36 machine_search_mcp是不是pass就知道。
第一份产出——直接对 Claude 说:
「抓一下 example.com 的文字,转成 markdown」
想要更多?(都在配置详解)
- 搜东西 → 通常零配置(机器已配智谱 MCP 即可);想加第二源再配 Brave key
- 抓登录态页 → 跑一次
lasso launch-chrome - 控 macOS 桌面 → 跑一次
lasso doctor授权
key 怎么申请、免费额度多少 → Key 配置指南。
能帮你做什么
按你想干什么分组,不按工具名。每组都是一句话进、一句话出。
搜一下
你:「搜一下 X」 → 结构化搜索结果
默认优先复用机器的智谱 MCP(中文主力,零配置),可选再配 Brave 做多源(Bing 与智谱直连两个死层均已移除,历史配置键保留但会被静默忽略)。任一家临时限流或挂掉,自动切下一家,你无感。某家免费额度用完也不影响整体。
搜完想顺手拿正文:说「搜索并带 3 条正文」(
content_blocks: 1-5,v1.17)——拿到蓝链后立刻并发抓 top N 页面正文,按你的查询词裁剪到 ~6k 字符(导语必留、关键词段优先),一步拿到「链接 + 能直接读的内容」。抓不到的条目如实标注(fetch_failed/not_html),蓝链照给,你或 AI 再决定要不要开浏览器补。零付费依赖,不起浏览器。
要查新闻、版本动向这类时效内容,直接说「搜最近一周 / 最近一个月的 X」——自动带时效过滤(day / week / month / year,v1.11),不用往查询词里手写日期。
搜你电脑里的东西(v1.17 新)
你:「我最近看过哪些关于 X 的页面」 / 「本地哪些文件提到 X」 → 本地私有搜索
search_local 直查你本机的 Chrome 浏览历史(多 Profile 都扫)和 Spotlight 文件索引(mdfind)——不出网、不碰云。隐私红线内置:只返回标题 / 链接 / 时间 / 标题匹配片段,永不全量导出页面内容,单次最多 50 条,对源库只读。Apple Notes 全文检索暂未开放(诚实返回「未实现」而不是装作查过了)。
抓公开页(不用登录)
你:「抓 example.com 的文字」 → 干净正文,三种粒度可选
自动剥掉导航条、广告、侧边栏等冗余,省 30–70% 字数(也更省钱)。GitHub / Reddit / Hacker News / Wikipedia / Substack / Medium 等 20 多个高频站点走专用抽取器,表格、数学公式这些结构也不丢(v1.12)——正文里的链接都是完整可点的绝对地址。要带引用角标(适合做调研、喂给 RAG)也能一句话切换。
读完想就地续操作(点按钮 / 填表单):说「抽取时带上交互句柄」(
include_refs,v1.17)——markdown 末尾附一张[r1] button "提交"式句柄表(正文本身零标记),之后「点 r1」「往 r2 填 X」直接按句柄定位,不用再跑整页快照。页面变了句柄会诚实失效
往输入框打字(v1.29):对 Claude 说「在这个搜索框逐字输入 XX」——
action:"type"走逐键可信输入管道(浏览器标记isTrusted:true,React 等受控框架的 onChange 正常触发、失焦后值存活——fill的批量设值会被这类框架在失焦时回滚)。长文本也是逐键;追加语义(不清空原值,fill才是整体替换);回车用{action:"press", key:"Enter"}。检测到站点拒绝程序化输入时返回体会带input_guard_suspected信号与三条出路提示(换 type / 重新抽取走 uid 路 / 请你亲手输入)——只提示、绝不替你绕过站点的输入保护。(返回 didnt + 提示重新抽取,不瞎猜不自动重试)。
v1.5 起,
browse_headless默认开启反检测(伪装 UA / 抹除navigator.webdriver/ 伪造 webgl、plugins、codecs 等共十几路)。无需配置,自动生效——很多「检测 headless」的站点现在能直接抓(v1.8 修复了一个注入静默失效的缺陷,现在是真的生效,且注入失败会在日志里如实报错)。v1.11 起反检测在浏览器启动层就生效:UA、视口、语言随档案统一下发,网络层 HTTP 头和页面 JS 看到的是同一套值,不再自相矛盾;v1.12 起 macOS 上默认指纹与你的系统对齐(不再「UA 说 Windows、机器特征招供 macOS」)。只有 Cloudflare 级重度反爬才需要走云浏览器(见下方「反爬强攻」)。想验证反检测效果?跑lasso doctor --stealth-check看 creepjs 检测对比。
测本地 HTML 文件(单文件交付物、离线产物验收):
file://链接默认拒(防注入的 agent 顺手读你本地盘);对 Claude 说「打开 file://…」被拒时会带 opt-in 指引——设LASSO_ALLOW_FILE_FROM=/你的项目目录后,browse_headless/browse_logged_in即可导航/快照/抽取/截图指定目录子树内的本地文件(../穿越、symlink 逃逸、目录前缀伪造全封口;fetch_url等其余工具仍保持 http(s))。
抓登录态页(有 2FA 的也行)
你:「看看我 Jira 的待办」 → 登录态页面快照
复用你本机已经登录好的 Chrome——你自己把 2FA 解了,Lasso 接管后续抓取。支持私有的 GitHub 仓库、公司内网、付费订阅内容等。
🔴 红线:Lasso 不替你解 2FA / 短信验证码 / CAPTCHA / 邮件魔法链接。这些必须你在本机 Chrome 里手动过一次。
🛡️ 高风险操作回合内确认(v1.17):自动操作碰到富文本编辑器、拖拽、瞬态弹窗这类高风险 pattern 时,若你的客户端支持 elicitation(Claude Code ≥ 2.1.76),会在同一回合内弹确认让你选「继续 / 跳过 / 终止」——选了继续才执行,不再直接中断整轮重来。老客户端行为不变(照旧安全拦截)。确认只对当次有效:每次命中都会再问你,不会记住授权。
远端机的登录态接力(v1.31 新)
你:「在这台 Linux 服务器上抓我要登录的那个站」 → 一条链接,你点开登一次,剩下的它全干
Lasso 跑在 Linux/内网机(比如你 Tailscale 里的云主机)而目标站要登录时:login_bridge 返回一条 URL,你在自己电脑的浏览器里打开、在投屏里亲手登录——登录态直接落在远端 Chrome 的持久 profile 里(零 cookie 同步、零本机操作),agent 看到 cookieDelta 增量即知登录落位,随后用同一个 Chrome 带登录态继续无头作业。用法四步:start 拿链接 → 你登录 → status 确认 → browse_logged_in 续跑(LASSO_CDP_PORT attach,配置见 配置详解)。诚实边界:投屏内中文输入法/密码管理器不可用(手输密码);Google 系登录对无头不稳;中转无鉴权(内网用,建议 Tailscale ACL)。完整排障见 TROUBLESHOOTING §11。
直接抓字节(最快最省)
你:「GET 这个 JSON 接口」 → 原始字节
不需要渲染整页的场景,直接走原始 HTTP,比走浏览器快约 4 倍、便宜约 4 倍。按内容类型自动识别(JSON / 文本 / 二进制)。
下载文件(v1.30 新)
你:「把这个 ISO 下到下载文件夹」「这两个视频连字幕一起下下来」 → 落盘文件路径
GB 级大文件、视频、磁力链接——直接下到磁盘,不进对话上下文(fetch_url 的 16MiB 小体量帽保持不变,各司其职)。三引擎自动路由:直链多线程+断点续传(aria2c)、流媒体+字幕+纯音频(yt-dlp)、单流兜底(undici)。下载进程独立存活——Lasso 重启也不中断;status:"all" 随时列回全部任务与产物绝对路径清单(跨会话交付物本体)。HTTP 任务中断后重发同一 URL 即字节级续传;多个任务并行互不阻塞。
诚实边界(BT/磁力):本机网络(广东移动家宽,2026-09-20 实测)存在运营商级 BT DPI 封锁——磁力任务 60 秒零 peer 时会同时报两个原因(死种 OR 网络封锁,不武断单因)并给出三条出路(换 http/stream 源 / 试 IPv6 / 换网络出口)。
安全面:落盘目录限白名单(默认
~/Downloads,LASSO_DOWNLOAD_DIR_ALLOWLIST可扩展);文件名强制 basename(禁路径穿越);单任务默认 5GiB watchdog 上限(超限即杀并标 oversize);http 直链走与fetch_url同一套 SSRF 守卫。
截图 / 存档
你:「截个整页长图」「存成 PDF」 → 落盘文件路径
所有图片和 PDF 都存到本地、返回路径,不会把一大坨图片数据塞进对话浪费上下文。超大文本输出(fetch_url / network 等)超过 48 KiB 也会自动落盘,返回预览 + @oN 续页句柄——用 read_text 工具按页续读(v1.8 起经 MCP 可直接调用)。要自定截图落盘位置(options.screenshot.filePath):默认拒(防任意路径写盘)——设 LASSO_SCREENSHOT_DIR=/你的输出目录 开放,且只允许写进指定目录子树(嵌套新目录自动创建也限在内);不指定路径时默认落 /tmp/lasso-screenshot-*.png,行为不变。
截「当前页面状态」(动画中间帧取证):
browse_headless/browse_logged_in的action=screenshot省略 url 即对当前受管页面直接截屏——零重导航,前面 evaluate 建立的页面状态(如document.getAnimations().forEach(a=>a.pause())冻结在 35% 的 CSS 动画)原样保留。推荐循环:带 url 的 action 建会话 →evaluate冻结/注入 →{action:"screenshot"}(无 url)截当前帧 →console取证——同会话四通道闭环。独立screenshot工具省略 url 同义(绑 headless 会话;logged_in 会话的当前帧用browse_logged_in)。无活动会话(冷通道/页面已关/被自愈换页)会显式报错(didnt+ 下一步指引),绝不静默新开浏览器、绝不截空白页伪造状态;带 url 的旧用法行为零变化。
看一个页面加载了什么
你:「这页加载了哪些第三方跟踪?」 → 资源列表 + 跟踪域名计数
自动识别页面加载的全部资源,按第三方域名聚合,方便看隐私风险、性能瓶颈。v1.11 起资源采集直接走浏览器引擎的原生网络层——代理 / TUN 网络环境下也完整,每条资源还带请求方法和状态码。
排查页面报错:对 Claude 说「读一下这个页面的 console」——
browse_headless/browse_logged_in的consoleaction 直接读当前页自上次导航以来的 console 消息(console_level按严重度过滤 error/warn/info/debug,console_limit只留最近 N 条)。渲染类缺陷排查不再需要注入window.onerror绕路。顺带一提:你传了但当前 action 用不上的 options 键会在响应的data.ignored_options里如实列出——Lasso 不静默丢参数。
控桌面原生 app
你:「把深色模式关掉」「读一下 Mail 收件箱第一条」 → 自动操作(带验证)
macOS 上能控 Finder / Mail / Safari / Notes / 系统设置等任何原生 app,Windows / Linux 也能控(见下方诚实边界)。操作带结果验证——做完了会确认「真的做完了」,不伪造成功。
诚实边界:macOS 经真实环境验证;Windows / Linux 编译和契约层都通过自检,但真机完整手测仍在推进中。不伪造「已在 Win/Linux 上完整验证」。
跨网页和桌面统一调度
你:「列一下我现在能控的所有东西」 → 一个统一清单
网页和桌面窗口共用一套清单——你不用区分「这是浏览器里的」还是「这是桌面上的」,Claude 自己挑要操作哪个,后续都顺着这个清单走。
死链救活
你:「这个链接 404 了」 → 互联网档案馆最近快照
去互联网档案馆(Wayback Machine)查这个链接最后一次被存档是什么样。不会主动把活链当死链处理,只在你说「找不到了」时才查。
订阅官方博客 / 追最新版本(v1.16 新)
你:「claude-code 最新版本是多少」「官方博客最近说了什么」 → 结构化条目列表
给它一个 RSS / Atom / JSON Feed 地址,直接拉成带标题、链接、发布时间的条目列表(约 200-500ms,零 key)。搜索索引要滞后几小时到几天,feed 是发布即推送——追版本号、退役时间线、官方公告这类「要新」的问题,问 feed 比搜一遍更准。官方博客的 feed 地址通常藏在页面头部的 <link rel="alternate"> 里,让 Claude 先 fetch_url 一下就能发现。
生态搭配(推荐但可选):常写代码的话,建议另装 Grep by Vercel 的官方 MCP(免费,索引 100 万+ GitHub 仓库的真实代码用法)。「别人怎么写」类问题它比任何网页搜索都准——Lasso 不内置它,各干各的活,互不重复。
反爬强攻(默认关)
你:「这个站有 Cloudflare,抓不动」 → 云端 Chrome 反爬
默认完全关闭。只有你明确要开、并且配了云浏览器(自托管 Steel 或托管型 browserbase/stagehand),才会启用。轻度反爬 browse_headless 自带反检测就能过,只有 Cloudflare 级重度反爬才需要走云浏览器。
- Steel 自托管(推荐 · 免费):本地 Docker 跑一个开源云浏览器,零 per-session 费、cookie 不出本地。一行命令开通,见 Key 配置指南 · Steel。
- browserbase(托管型 · 付费):试用后按量付费,不想自己跑 Docker 时的备选。
- stagehand(托管型 · 付费):⚠️ 程序化实验通道——配 key 只装配内部 channel,没有 MCP 工具入口(REST 契约未经验证;
lasso doctor#39stagehand_rest_contract_probe专测此项)。
安装
当前版本 v1.34.0(更新日志见本节末尾折叠块)。
前提:Node.js ≥ 20 + Claude Code(或任何支持 MCP 的客户端)。
运行时依赖一览(哪些能力要装什么、缺了会怎样——lasso doctor 一键检查在位性):
| 依赖 | 服务的能力 | 必需性 | 怎么满足 | 缺了的行为 |
|---|---|---|---|---|
| Node.js ≥ 20 | 全部 | 硬前提 | 手装(nodejs.org) | 无法运行 |
| MCP 客户端(如 Claude Code) | 接入面 | 硬前提 | claude mcp add 见下 |
无调用方 |
| Chrome / Chromium 浏览器 | browse_logged_in(复用你本机 Chrome)/ 渲染档 / 登录接力档(login_bridge)/ browse_headless + browse_headed |
全部需要(headless 例外见缺失行为) | 手装,或 headless/headed 栈经 LASSO_CHROME_PATH 指向任意可执行 Chrome 二进制(Chrome for Testing 便携版亦可;doctor #5 检查) |
无系统 Chrome 时 browse_headless/browse_headed 会启动失败并给出两步教学(配 LASSO_CHROME_PATH → admin browser_recycle 重试)。勘误(2026-10-28):早期版本声称 headless「免预装自动拉 bundled Chromium」——该通道在锁定的上游 1.7.0 下结构性不可达(channel 恒被默认为 stable,仅查系统装位),声明作废;渲染/登录档缺 Chrome 时给可教学错误 |
| aria2c | download 直链多线程 / 磁力链接 |
可选 | 手装(macOS brew install aria2 / Debian apt install aria2;doctor #40) |
HTTP 下载自动降级 undici 单流引擎仍可用;磁力链接显式不可用(unavailable + 引导提示) |
| yt-dlp | download 流媒体 / 字幕 / 纯音频 |
可选 | 首次用到时 lazy 引导下载(SHA256 钉版校验,doctor #40)或手装 | stream 类任务触发引导;拒绝引导则该类不可用 |
| lasso-rust-helper(二进制) | 仅 macOS desktop 桌面控制 |
仅桌面需要 | 预编译二进制单独分发,刻意不进 npm 包(见仓库 rust-helper/ 构建;LASSO_RUST_HELPER_PATH env 可指任意路径;doctor #15/#16 引导 + TCC 权限) |
desktop 返 rust_helper_crashed 四态自诊断(TROUBLESHOOTING §2.16);Linux/Windows 桌面走 UIA/AT-SPI 路线(编译可证) |
| key 类(Brave 等) | 搜索第二源等增强面 | 全部可选 | 见 KEY-GUIDE / 费用一览 | 零 key 即装即用(默认通道全免费) |
一句话:零依赖也能跑(headless 浏览器自动拉、桌面外全本地);要登录态/渲染/桌面/磁力/流媒体时才按上表补对应依赖。
claude mcp add lasso -- npx -y lasso-mcp
重启 Claude Code → /mcp → lasso ✓ Connected。就这一行,不带任何 key——装完抓页 / 截图 / PDF / 控桌面立即可用,只有搜索可选配 key(见配置详解)。
macOS 想控桌面:跑一次 lasso doctor,按提示给 lasso-rust-helper 勾上「辅助功能」和「屏幕录制」权限即可,doctor 会一步步引导。
给其它 AI 工具当确定性渲染浏览器(渲染档):如果你在用 media-gen-mcp 这类要求「同一输入必须产出同一像素」的渲染工具,装好 lasso 后只需一行 npx -y lasso-mcp render-chrome --ensure——它会在 9224 端口拉起一个确定性 headless Chrome(冻结旗标快照 + 独立临时 profile),输出消费方直连用的 wsEndpoint;消费方进程被强杀浏览器也照常存活(生命周期归属 lasso),空闲 10 分钟自动回收并连带清理 profile(LASSO_RENDER_IDLE_MS 可调)。配套:render-chrome --status 自省 / --stop 收尾(认 LASSO_RENDER_PORT:显式设 port 只收该 port,未设=全部 render 记录,非法值 exit 1;全局收口仍可用 chrome-stop --modes render)/ render-chrome doctor [--clean] 孤儿与陈年 profile 清理(默认只报告;认 LASSO_RENDER_PORT,同 --stop:显式设 port 只判该 port,未设=全扫,非法值 exit 1;touch 心跳 10 分钟内的在用实例豁免不判孤儿)。同机多 agent 并行验收(多个 agent 各自清场会互杀对方实例)需配三 env 契命名空间隔离:LASSO_RENDER_PORT + LASSO_LAUNCHED_CHROMES_PATH + LASSO_RENDER_GUARDIAN_PID_PATH,配齐后并行互不可见,配方与清场纪律见 doc/渲染档-并行验收隔离配方.md。
-
v1.34.0(台账读点对账——京东云僵尸台账根治):京东云实测发现 Chrome 在 lasso 生命周期外死亡后台账条目永挂(pid 死亡仍记 ready/visible:
doctor误报为用户显式滞留、chrome-status教的chrome-stop --zombie-gate清账命令被 gate 拒绝=指令面死锁)。架构级根治(不变量先行):INV-L「凡readLedgerSync()返回的记录 pid 必活」——死条目在读取点物理消亡,寿命 ≤ 一次读取;「销账不需要杀授权」(gate/modes/userTaken 豁免挡 kill 永不挡销账——「资产」与「资产的账面记录」正交)。实施:①readLedgerRawSync纯解析拆分(五写原语体内改调 raw——防读-销互递归)+writeLedgerAtomicSync原子写单实现;②readLedgerSync内建 ESRCH-only 探活销账(EPERM 保守判活;evtledger_stale_reconciled;mode-blind 全档适用——visible/login/render 死条目同收)+ render 档连带临时 profile 盘清理(cleanupRenderProfile自 chrome-stop 搬入,依赖方向保持单向);③ 12 个台账消费模块(launch-chrome/idle-reaper/chrome-status/doctor×2/chrome-stop/enforcer/watchdog/LoggedInChannel/login-bridge/render 系/hideshow-cli)零改动自动继承活账语义;④ 新 INV-111 四子断言(对账段存在性/防递归/mode-blind/测试钩子生产不可达)+ INV-78(f)/86(c) 解析守卫锚随迁;⑤ 全局测试恒活 setup(27 个既有台账 spec 零适配)+ 对账 spec ×9(京东云形态回归锚/防线负测——活 visible 仍 gated_skipped 零 kill)。kill 面三红线(INV-82/v1.17.3 P1/BUG-03 r2-F1)零触碰。三路隔离审查(正确性+否定尝试/纪律+INV/最简等价解)全 findings 并入,CLI 端到端实证:种死 pid visible 条目 → 一次读取 → 台账自清 → doctor 恢复 pass。全案doc/提案-台账生命周期读点对账-2026-10-29.md。 -
v1.33.1(发布卫生双修——白盒根因批):① 包形态 invariants 假阳性根治:4 项 INV(76/77/101/103)的证据文件在
rust-helper/与test/下(npm tarball 刻意不含两者——v1.31.1 设计),包形态下旧代码catch { return false }把「证据文件缺席」误当「断言被证伪」→ 每个 npx 用户的doctor恒报ready:false + blockers:['invariants'];现补 SKIP 第三态(rust-helper/src与test/helpers两者同时缺席才判包形态,锚 checker 文件自身位置——inv-selftest 临时副本免疫、仓库/CI 形态 byte-identical 零变化;只缺其一=仓库损坏→维持红);包形态汇总行诚实呈现All 106 invariants passed, 4 skipped (package form).。② 发布白名单:.npmignore黑名单语义下根级新文件默认入包(同类第三次复发——v1.33.0 曾误入一个本地私有文件,该版本已弃用/撤下,1.33.1 为替代版本)→ 改/*全忽略 +!精确重入惯用法 + doc/ 子树下钻一层(敏感资产驻地:新建子目录默认排除、顶层 *.md 自动入包);刻意放弃 package.json files 字段方案(实证 files 列目录会覆盖 npmignore 子树剪枝——得到/history 等 247 条会重新入包);有意 drop:tsconfig.json、vitest.workspace.ts(历来顺带入包、无运行时消费方)。③ 新门测试test/unit/npm-tarball-package-form.spec.ts(5 用例:真 npm pack 白名单门 / 包形态 checker 三态 / 防线削弱负测——补空 rust-helper/src 后同 4 项必须 FAIL 而非 SKIP)+ tar 条目八进制转义解码(GNU tar\NNN形态下中文路径断言曾全程假绿,实锤修正)。隔离审查(正确性+纪律双镜头全实证)四 findings 均已落改。 -
v1.33.0(game 升级反馈批:浏览器路径覆盖/渲染正确性信号/SSRF config 通道):2026-10-28 畸变协议 Web 部署方反馈单(Debian 13 无显示服务器/无预装 Chrome 环境)四项裁定 + 四笔单主题实施(裁定与 3 路隔离审查全记录见
doc/提案-game升级反馈P1-P4裁定-2026-10-28.md)——① P1LASSO_CHROME_PATH(新 config 键,无系统 Chrome 机器的唯一通路):勘误定谳——旧版 README「browse_headless 免预装(自动拉 bundled Chromium)」声明无条件为假(chrome-devtools-mcp@1.7.0 middleware 四空默认 channel='stable' → puppeteer-core 在 channel 已设时只走系统装位解析,cache 下载分支结构性不可达——v1.11 锁版迁移的隐性回归,开发机全有系统 Chrome 从未暴露);新键在registerSpecWithIdentity消费点懒读(mergedEnv,非构造注入)透传上游原生--executablePath(与--headless --isolated兼容),覆盖首注册/freshProfile/idle 回收三重建路径(idle 收割自动吸收 config 变更);作用域 headless+headed(headed 需完整 Chrome——chrome-headless-shell 无窗口能力),cloud/attach 通道排除(上游互斥组实证);chrome_missing 错误面给两步教学指引(config →admin browser_recycle→ 重试)、doctor #5 扩回显+X_OK 校验、旗标契约锚×4 测试(上游 yargs 无.strict()——拼错静默哑弹,故锚测试是硬要求);② P2 截图/浏览 advisoryconsole_errors:screenshot与browse返回附 error 级 console 摘要(条数+首条截断)——骑既有上游list_console_messages零新依赖,best-effort(console 调用失败→字段缺省、截图绝不整体失败),只在 error>0 时出现(最优条件信号);四层触点(BrowseChannel 采集/types 契约/工具信封/browseSingle 最终信封)+ L1 fleet 预算帽 64500→64900(+400,单主题独立 commit);③ P3 Firefox 通道维持拒绝(bugs/09 新组件红线 + 需求方 firefox-esr 自证无头 WebGL 不可用、做了也解不了其场景),精神采纳:Chrome for Testing 便携版自助指引入错误面/doctor/KEY-GUIDE;README 依赖矩阵 Chrome 行按 F3 定谳重写;④ P4 SSRF 三键 config 通道:LASSO_SSRF_ALLOW_RANGES/LASSO_SSRF_DENY_RANGES/LASSO_ALLOW_FILE_FROM除 env 外可走 config.json(装配期 mergedEnv 快照——重启 MCP server 生效;二跳 fallback 热生效;「可扩展不能缩小」+deny 优先序不变)——v1 的「热生效」形态被三审查证伪为假修复后按诚实方案收窄,真热化(thunk 化 ~15 处注入)登记为升级路径。 -
v1.32.0(launch-chrome locale 配置化与参数保真·R1):2026-10-26 需求单(make-money 飞轮,登录态采集五站)四项裁定 + R1 实施——① locale 配置化:
lasso launch-chrome --locale zh-CN或 config 键LASSO_LAUNCH_LOCALE——launch 前写入托管 profile 的Default/Preferences(intl.accept_languages/selected_languages,Chrome 155 起优先级高于一切命令行开关——需求方三条命令行路径实测全灭的根因)+--lang双保险;本机冒烟实测 Accept-Language 头zh-CN,zh;q=0.9与navigator.language==="zh-CN"双口径逐字节达标(Chrome 会把预种值规范化为存储形态zh-CN,网络栈自动派生,zh;q=0.9回退——与真实中文用户同形态,良性);② 参数保真:config 键LASSO_LAUNCH_EXTRA_ARGS持久化自定义 flags(空白符拆分——--window-size=1920,1080类含逗号参数完整保真;与 CLI--extra-args逗号语义并存);两键双档生效(日常档 launch-chrome + 登录档 login_bridge;locale 类跨档语义键不分档——与 idle 分档五键惯例的显式偏离决策,login-flags owner 对照登记);③ best-effort 非门禁:非法 tag(zh_CN下划线误配形态)/ profile 被在跑实例持有(写前台账守卫)/ Preferences 写失败 → 结构化日志放行不阻断;实例复用时打点chrome_locale_prefs_skipped_reused(locale 冷启生效,先 chrome-stop);原子写(tmp+rename)保护登录态资产;④ 同单 R2(rebrowser 化)/R3(humanize 行为模拟)维持既有 rejected-by-design 裁定(R2 重启条件=「CDP patch 后通过 tm 类站点」可复现 L3 实证非厂商自述——需求单证据全为机制存在性证据;R3 双重否决 + 意图伞论证),R4(doctor 指纹体检)暂缓(重启路径在册)——裁定与 5 路隔离审查(正确性/需求覆盖/最简等价解/纪律/简单架构,膨胀系数 1:1)全记录见doc/提案-需求单R1-R4裁定与R1实施-2026-10-26.md;⑤ 新增chrome-profile-prefs共享模块 + 15 例新测试(覆盖既有 en-US 值=需求方第一真实路径/台账守卫/零变更锚)。 -
v1.31.1(依赖清单能力补齐):README 双语新增**「运行时依赖一览」矩阵**——依赖 × 服务能力 × 必需性 × 满足方式 × 缺失行为七行全表(Node/MCP 客户端/Chrome/aria2c/yt-dlp/lasso-rust-helper/key 类),全部源码级核实:
browse_headless免预装浏览器(chrome-devtools-mcp 首跑自动拉 bundled Chromium);aria2c 缺失时 http 降级 undici/磁力显式 unavailable;yt-dlp lazy 引导下载(SHA256 钉版);rust-helper 刻意不进 npm 包(单独分发+LASSO_RUST_HELPER_PATH);收尾一句话「零依赖也能跑,按需补装」。lasso doctor一键检查全部在位性。纯文档版(零代码变更,为此单独发版使 npmjs.com 包页同步呈现)。 -
v1.31.0(login_bridge 登录接力档):远端无头浏览器登录接力——Linux/内网机上跑 lasso 遇登录墙时,
login_bridge({action:"start"})返回一条 URL,你在本机浏览器打开、在 DevTools screencast 投屏里亲手登录,登录态直接落在远端 Chrome 的持久 profile(零 cookie 同步),agent 轮询status看cookieDelta(按域新增非噪声 cookie——启发式事实)即知登录落位,随后browse_logged_in经LASSO_CDP_PORTattach 同一 Chrome 带登录态续跑;stop(可wipe:true连登录资产一并清)。实现四件:登录档 Chrome(持久 profile+台账第五档 launchMode "login"+单飞锁+收尸委托)/哑 TCP 转发(~30 行字节透传,lasso 首个入站监听——只在 start 后存在;F2 对抗定谳:Chrome ws URL 从 Host 头生成,哑透传天然全链自洽,token 中继是结构性矛盾故砍)/绑定地址三序解析(env 显式含 0.0.0.0 自担→tailscale CGNAT→私网兜底)/doctor #43。诚实披露面:投屏内中文输入法与本机密码管理器不可用(手输 ASCII 密码);Google 系登录对 headless 不稳(云 IP 信誉自担);relay 无鉴权=绑定接口内任意进程可全控(tailnet 私有性防线,建议 Tailscale ACL);登录 cookie 明文落盘。配套:fleet 预算帽 62,250→64,500(单主题提帽先例链)、INV-108 posture 红线、46 例新测试、方案与调研文档(doc/方案-login_bridge*/doc/调研-远端无头浏览器登录接力*)。 -
v1.30.4(版本号前进,内容与 v1.30.3 完全一致):npm 平台新政「staged publishing」在发布时占用了 1.30.3 版本号(staged 记录未 approve 前同名版本不可再发布,且本账户未开 2FA 无法处置 staged 记录),同内容改以 1.30.4 发布。发版侧备注:granular token 的包权限现分「Read and write」(可直接发布)与「Read and write (stage only)」(仅能进 staging 审批区)两型,自动化发版请选前者。
-
v1.30.3(bugs/15 飞轮批):长驻 Chrome 实例健康附注与身份契约——①
chrome-status对活实例新增evidence.health_note:宿主内存压力 warn/critical 或单实例 pages>12 时一行提示(覆盖正常使用与用户接管两种形态;纯提示,永不因此杀实例/不动分类契约/不进 kill 路径);② 身份契约三面披露(KEY-GUIDE/CLI --help/README):launch-chrome 的日常档 profile 是你亲手 2FA 的身份资产——Google 登录会经 sync 拉全量书签/关联域(想收紧--extra-args "--disable-sync",cookie 登录态不受影响);实例定位是登录态渠道实例不是第二浏览器,重度日常使用健康责任溢出 lasso 边界;③ 飞轮工作流两轮+深查(多 agent 隔离分析→否定重查推翻 3.5/6 项→简单架构单点收敛→测试先行→对照判定→飞轮自审——防过度工程,砍掉 doctor 新 check/CDP 扩方法/iframe 治理三处过度候选);④ 新增doc/usage/05-lasso审查清单(L1-L4 四组 15 条,基于架构想法 01/02/03 定制)。 -
v1.30.2(bugs/13 §10):载旧码一键裁决探针——新 doctor check
stale_runtime:本地 dist 开发模式下,运行中的 MCP server 是长命进程,dist 重建后旧进程仍载旧码(新修复不生效且症状可能是新形态错误)。现在调doctor工具即见:模块 mtime 晚于进程启动(+5s 容忍)→warn: carries pre-rebuild code+ 重连提示(CC 侧/mcpreconnect 即恢复;勿 kill server 进程——有工具失联风险;CLIlasso-mcp doctor恒 pass 是正确语义:新进程永载新码)。判据用 mtime 而非版本号——同版本号内多次重建也能判。配套 TROUBLESHOOTING §2.24。 -
v1.30.1(bugs/13+14+lovart 阻塞批):CDP 端口断层修复——①🔴 config 模板毒化(init 模板曾预填
LASSO_CDP_PORT:9222+键存在性判显式=自动发现被默认值永久禁用;模板留空+判显式收紧双修);② 连接失败可诊断性(错误附已试端口+发现状态+lasso 版本);③ 惰性 attach 调用期自救(lovart 阻塞-1:chrome-devtools-mcp spawn 成功后首次工具调用才连 CDP,该失败形态此前不进自动发现——browse 连接失败签名判定→自救→重试恰一次);④ config 热生效(lovart 阻塞-2:运行中的 server 热读~/.lasso/config.json的LASSO_CDP_PORT,写入即生效不用重启;优先于台账发现,env 显式仍恒赢);⑤ doctor 新 checkchrome_ledger_inventory(台账活实例清单;visible+idle-0 跨会话滞留 → warn+chrome-hide --port N收尾提示——永不自动收,INV-82);⑥ doctor 失败分支提示+描述文档对齐(README/KEY-GUIDE/TROUBLESHOOTING §10.1 非默认端口三步配方+热生效段)。审查循环 fresh PASS-WITH-CONDITIONS 六条件全清偿(变异实证守卫补钉)。 -
v1.30.0(下载器批,doc/bugs/12):新工具
download(action:start|status|wait|cancel)——通用下载器四动作(kind=auto 自动路由:直链→aria2c 多线程断点续传 / 流媒体站点→yt-dlp(音频+词级 json3 字幕)/ 磁力与 .torrent→BT 通道)。任务表磁盘持久(~/.cache/lasso/downloads/,lasso 重启后status收养续查);status:"all"返回产物绝对路径清单(跨会话交付物本体);wait≤120s 帽+轮询教学;cancel 只杀「台账在案+归属验证」的引擎树(kill 红线)。治理三件套:doctor 引擎 check+idle 硬顶 24h+活跃总量帽 16。安全面:http/stream 首跳 SSRF 守门、out_dir 白名单(默认 ~/Downloads)、filename 强制 basename、max_bytes 超帽 watchdog(杀树+oversize 态)。BT 诚实诊断:本机网络(广东移动)经真机四重实证为运营商 DPI 定向封锁(非 DNS 污染主因——DoH 同污染,IP 直写才是解)——60s 零 peer 报双因(死种 OR DPI)+三条出路建议;aria2 内置 IP 直写 DHT bootstrap+冻结 tracker 表。引擎引导:yt-dlp 缺失时首个 stream 下载自动拉取(pin 2026.08.19+sha256 校验);aria2 缺失时 HTTP 走 undici 内建降级。同 source 续传复用(.aria2 控制文件字节级续传)。审查循环三轮闭环(fresh 审查+mutation 红证)。 -
v1.29.2:文档批——type/press 输入原语(v1.29.0 引入)的调用示例补进工具描述 EXAMPLES 段与 README 用户向介绍;
input_guard_suspected信号的「三条合法出路」说明同步。纯文档/description 增强,无行为变化。 -
v1.29.1:发版修正——v1.29.0 的 npm 包携带了旧 dist(版本转正后未重 build 即 publish,
doctor自报 1.28.0);本版重 build 后发布,内容零变化。教训固化:版本三处改后必须npm run build再 publish。 -
v1.29.0(bug11:输入原语补齐 + 诚实信号批——「输入保护层」证伪重析,doc/bugs/11)——下午实机报告判定的 P0「tm.aliyun.com 输入保护层瞬间清除程序化设值」经白盒受控重析证伪:真机理是 React 16/17 受控组件的状态完整性语义(脚本写入不触发 onChange → blur/commit 时框架把 DOM 回写为已提交状态——值存活到 blur,非「毫秒级消失」;「六路全败」实为观察面错误:submit 走
window.open开新 tab、原页 URL 永不变 →wait url_contains结构性失明,而 uid 路 fill 当天全链路完成真实搜索)。本批交付物:①type/press输入原语补齐(click/fill/type 三原语的第三缺):action:"type"+selectors:{<uid|ref>:<text>}——逐字派发走 CDPInput.dispatchKeyEvent可信输入管道(浏览器标记isTrusted:true,进框架输入管道、React onChange 正常触发、blur 后存活;与 Playwrightpage.keyboard.type()同级;长文本亦逐字——覆盖 fill uid 路 ≥100 字符翻转进 JS 批量设值不可信管道的断层);追加语义(=Playwrightpage.type,fill 才是替换);ref 路 focus 回执失败显式报type_focus_failed(didnt 档,不猜);action:"press"+key:"Enter"(修饰键由上游拆解 + 失败释放保证)——实现为对已锁定上游type_text/press_key的映射(禁 CDP 直连);不暴露 submitKey(提交显式走后续 press/click,两步链更可审计)。②input_guard_suspected诚实信号(advisory,驱逐哨兵同范式):ref 路填充/键入内嵌三探针(value setter 非原生安装态 / ~250ms 页内读回不一致 / React tracker 分叉)——命中即附信号 + hint 三条合法出路(换 type 可信管道 / 重 extract 走快照 uid 路 / 请用户物理输入);只供信号绝不自动改道(不自动换原语/重试/通道),探测纯读零副作用(禁为探测合成 blur)。③ wait 超时观察面教学:wait_timeout错误追加 window.open 新 tab 教学句(原选中页 URL 永不变——该形态超时首次自带归因线索)+ TROUBLESHOOTING §2.19 新 tab 观察面(含 `navigate → wait{selector
Lasso MCP questions
How do I add Lasso MCP to Claude Code?
Run claude mcp add lasso -- npx -y lasso-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Lasso MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can it control my desktop applications?
Yes, it can control native desktop apps on macOS, Windows, and Linux through semantic clicks and keyboard inputs.