@extension.dev/mcp

中文文档
10.22.0发布于 2026/11/09Apache-2.0TypeScriptES Module近 30 天下载 2651

允许AI代理的MCP服务器(Claude Code, Claude Desktop, Cursor, Copilot, Codex)构建,运行,检查并发布浏览器扩展. 38个工具用于脚手架、现场DOM检查、日志流和Chrome、Edge、Firefox、Sa等地的储存准备建造

中文使用文档
文档目录19 节
  1. 为什么一个用于扩展的 MCP 服务器
  2. 看着它工作
  3. 浏览器
  4. 客户
  5. 设置
  6. 克劳德代码
  7. 光标
  8. VS 代码
  9. 代码
  10. 其他客户端(Claude桌面和.mcp.json)
  11. 旗帜
  12. 遥测
  13. 与技能对等
  14. 工具
  15. 别猜了
  16. 萨法里
  17. 平台( 私人 α)
  18. 社区
  19. 许可证

@ extension.dev/mcp Version Downloads Discord

给您的AI代理手进行浏览器扩展开发. 38个MCP工具用于脚手架,运行,检查,调试,测试,并在你的机器上建立交叉浏览器扩展,外加一个平台道(private alpha)来共享并发布.

Logo
claude mcp add extension-dev npx @extension.dev/mcp

与克洛德代码,克洛德桌面,Cursor以及任何MCP客户端合作.

扩展名.dev • 妇女 文档 • 妇女 模板 • 妇女 解析器

为什么一个用于扩展的 MCP 服务器

扩展失败无声:从未注入的内容脚本,从未打开的面板,返回的权限 undefined 没有错误。 这些工具让代理在直播浏览器上看到,因此它从证据中调试而不是猜测.

  • 脚手架 从后面的50+模板 模板.扩展.dev,或者在现有工程中添加弹出、侧边栏或内容脚本
  • 运行 chrome、Firefox、Edge和HMR的dev服务器 下方每个浏览器,加上macOS上的Safari(还没有HMR)
  • 见 现场DOM,每个扩展上下文的日志, chrome.storage,以及加载扩展列表
  • 行为: 在任何上下文中评价代码, 触发动作按钮和命令, 重新装入扩展名
  • 测试: 状态对运行中的延期的期望, 并获得一个判决
  • 船舶:验证已显示的交叉浏览器并用于生产。 打开 平台车道: 共享预览链接, 推动构建, 并提交到仓库

建造在 电话分机.js,开源框架扩展名。 dev赞助商. 每个引擎命令都运行项目 node_modules/.bin/extension 当项目有一个, 否则 npx extension@<pin> 在版本中此服务器针( e)EXTENSION_MCP_CLI_VERSION 更改接头). 运行一个尚未运出的修复器, 设置 EXTENSION_MCP_ENGINE_DIR 转到已编译的扩展.js 检查出根(文件夹持有) programs/extension/bin/extension.cjs)或致建筑物 extension 软件包文件夹( 持有) bin/extension.cjs:每个产卵然后运行 node <that bin>项目的引擎和针被绕过, extension_doctor是因为 project-engine 检查路径名称及其版本, sha和分支, 和没有 bin 的路径拒绝每个产卵, 而不是掉回 . EXTENSION_MCP_ENGINE_BIN 指定确切的本文件.

看着它工作

Asked to run the extension, the agent starts the dev session, Chrome opens with it loaded, and the agent reports the session, from a real Claude Code session

浏览器

extension_dev 在您命名的浏览器中打开扩展名.

ChromeChromiumEdgeBraveOperaFirefoxSafari
谷歌颜色铬微软边缘勇敢点歌剧Mozilla Firefox 喷出火花苹果沙发

Chromium家族和Firefox获得HMR,控制,eval,检查和断言(Firefox关于其调试器协议和代理桥,没有CDP). Safari在macOS、无HMR、无检查的基础上工作 萨法里加上维瓦尔第,扬德克斯,沃特福克克斯,禅和克洛斯普,以及任何克洛米姆或盖克多二进制.

客户

Claude CodeClaude DesktopCursorVS CodeCodex
克劳德代码克劳德桌面光标VS 代码代码

设置

克劳德代码

claude mcp add extension-dev -- npx @extension.dev/mcp --features=local,platform

或安装为插件, MCP 服务器加 /extension, (中文(简体) ), /extension-add, (中文(简体) ), /extension-debug,以及 /extension-publish 步骤中的命令 :

/plugin marketplace add extensiondev/mcp
/plugin install extension-mcp@extensiondev-mcp

光标

Install MCP Server

或贴上 .mcp.json 下方块为 .cursor/mcp.json。 。 。 .

VS 代码

code --add-mcp '{"name":"extension-dev","command":"npx","args":["@extension.dev/mcp","--features=local,platform"]}'

或者把它贴入 .vscode/mcp.json 下级 servers,与 "type": "stdio" 在条目.

代码

codex mcp add extension-dev -- npx @extension.dev/mcp --features=local,platform

或写入 ~/.codex/config.toml 作为 [mcp_servers.extension-dev] 相同的表格 command 财务报告和审定财务报表 args。 。 。 .

其他客户端(Claude桌面和.mcp.json)

.mcp.json数字 :

{
  "mcpServers": {
    "extension-dev": {
      "command": "npx",
      "args": [
        "@extension.dev/mcp",
        "--features=local,platform"
      ]
    }
  }
}

旗帜

  • 默认情况下,服务器会曝光其38个工具中的25个使用此机(13个平台工具已关闭). --features=local,platform 新增平台组. 信封 : EXTENSION_DEV_FEATURES。 。 。 .
  • --no-ship 拒绝每个将某事放在他人面前的电话(出版,促销,真实提交,共享预览,撤销). 信封 : EXTENSION_DEV_NO_SHIP=1。 。 。 .
  • --project <workspace>/<project> 将服务器插入一个工程。 信封 : EXTENSION_DEV_PROJECT。 。 。 .
  • 当平台行为回答时 approval-required 在桌面上(不是无头,不是CI,和带有显示功能的Linux),服务器在默认浏览器中打开一次批准页面. --no-ship 或者说 EXTENSION_DEV_NO_AUTO_OPEN=1 关掉它.

一个被拒绝的呼叫回答 E_TOOL_DISABLED 换上国旗 人类批准提交储存材料和稳定升级,MCP说明每个工具都携带 <untrusted-data-ID> 页面写作文本周围的栏杆如下: 服务器旗。 。 。 .

遥测

extension_create 发送一个 draft_seeded 到 PostHog 时的事件 us.i.posthog.com 在成功脚手架(template sphot, source and controduct,随机的每个进程会话id,从没有路径或名称)后,平台工具会随他们的呼叫发送一个每个安装id头. EXTENSION_DEV_NO_TELEMETRY=1 或者说 DO_NOT_TRACK=1 停止两个。 全部有效载荷列于 遥测。 。 。 .

与技能对等

此服务器会给代理机手; @extension.dev/skill 给他们判断:交叉浏览器规则、无声失败的游戏机、调试游戏本和存储核对表 代理技能 格式。 包裹还装有克洛德密码规则 和四个斜线命令 claude/。 。 。 .

npm i -D @extension.dev/skill
mkdir -p .claude/skills && cp -R node_modules/@extension.dev/skill/skills/extension-dev .claude/skills/

工具

默认情况下,这台机器上的25架:

级别工具说明
构建extension_create模板中的脚手架
构建extension_templates浏览 50+ 模板 (S)list)并读取一个人的来源(source(中文(简体) )
构建extension_docs_search通过关键词搜索扩展名.js和扩展名.dev docs
构建extension_add_feature计划一个选项页、 弹出、 侧面板、 内容脚本、 devtools 面板或对现有工程的新标签页
构建extension_build生产建筑
运行extension_dev带有 HMR 的 Dev 服务器
运行extension_start建设+启动生产建设build: false (一) 发射现有圆盘; outputPath 发射任何预建的无包装目录)
运行extension_try运行一个已出版的扩展.dev在新鲜的本地浏览器中构建,使用一次带有截图,并说它能达到什么; action: "close" 移除它
运行extension_wait把德夫服务员的合约
运行extension_stop停止 Dev/ start/ preview 会话( 服务器 + 浏览器)
见extension_manifest_validate交叉浏览器显示校验
见extension_analyze磁盘上已建扩展的静态分析
见extension_inspect深入现场检查运行中的扩展(封闭的阴影根,探测器)
见extension_dom_snapshot选中标签或扩展面的浅色 DOM 快照
见extension_screenshot打开扩展面或页面的屏幕截图, 保存在会话调试端口上的 . png
见extension_list_extensions列出已装入的扩展名( Chromium and Firefox)
见extension_logs从每个上下文流出日志
见extension_doctor逐条诊断dev会话段( 已准备好的合同、 端口、 令牌、 执行器、 浏览器)
见extension_theme_verify校验显示色调主题的颜色
测试extension_assert国家期望延期,并获得一个判决:通过、失败或无定论
动作extension_eval上下文评价( 需要) allowEval: true 打开 extension_dev(中文(简体) )
动作extension_storage读取/写作 chrome.storage
动作extension_reload重新装入扩展名或标签
动作extension_open打开表面( 弹出、 选项、 侧边栏、 devtools 面板、 覆盖页面) / 触发 action, (中文(简体) ), command
浏览器extension_browsers检测、列出、安装和卸载浏览器

继续 --features=local,platform,到达扩展的12个。 dev 平台( 私人 α ):

级别工具说明
平台extension_auth设备在扩展名下登录. dev用于一个工程或其中的列表,加上登录状态和登录
平台extension_workspace_create通过设备批准创建扩展.dev 工作空间, 无头; 批准者成为其所有者
平台extension_project_create为已建扩展创建扩展.dev项目, 或在一个批准下创建几个项目, 无头, 通过设备批准
平台extension_preview_web在网络仿真器中创建一个构件,并作为链接共享
平台extension_shares列出您共享的每个链接, 作为链接共享一个平台构建, 并永久取消一个
平台extension_publishMint 可共享的构建扩展链接 。 dev 已经持有( 没有上传)
平台extension_release_promote释放一个构造到频道, 无头
平台extension_submit提交储存审查:Chrome、Firefox、Edge和Safari,通过扩展
平台extension_submit_check在只读的提示下, 读取商店的准备状态和状态, 排练, 并请求批准
平台extension_release_status读取发布通道、发布历史、最近构建以及存储配置、提交和审查状态
平台extension_approvals读取一份批准书,或撤销一份待决或批准或未使用批准书,使其永不运行
平台extension_builds阅读平台的建筑(最近的建筑,一个建筑的文物和完整性,它的CI日志),将一个建筑的软件包保存到与其完整性报告核对的磁盘上,启动重建,改变建筑设置作为所有者代号下的普通调用,并添加一个发布通道
平台extension_workspace读取任何项目登录的工作空间:计划和限制、项目和最后的构建、使用和项目设置

Dev 会话带有控制通道 extension_storage, (中文(简体) ), extension_reload, (中文(简体) ), extension_open 财务报告和审定财务报表 extension_dom_snapshot 骑行:是本地、同一台机器、同一用户和开机,除非 extension_dev 调用 allowControl: false。 。 。 . extension_eval 只有一个门,直到 allowEval: true 被传递 extension_dev (这意味着控制). 会议不会在第二次打电话时改变大门:打电话 extension_dev 再说一遍,你需要什么 replace: true,从而停止了第一课.

别猜了

所有其他工具都拿回读数. extension_assert 说明预期结果并回复判决.

Asked whether the extension works, the agent runs it, states expectations and reads one verdict each, from a real Claude Code session

{
  "projectPath": "/path/to/extension",
  "expect": [
    { "assert": "background-worker-booted" },
    { "assert": "surface-rendered", "surface": "popup", "selector": "[data-testid=root]" },
    { "assert": "storage-key-present", "key": "settings", "area": "local" },
    { "assert": "console-errors-empty", "context": ["background", "popup"] },
    { "assert": "content-script-injected", "url": "https://shop.example/cart" },
    { "assert": "no-outside-requests", "allow": ["api.shop.example"] }
  ]
}

每张支票都回来了 pass, (中文(简体) ), fail 或者说 inconclusive,而跑步只有在每张支票通过时才会通过. inconclusive 意味着这个平台无法覆盖今天的问题, 而支票携带 settledBy 命名将回答它的证据:一个内容脚本只通过它自己写的一行,“没有控制台错误”在从未构建的会话上是没有定论的,读到会话就会拒绝(chrome.storage 开始的会话 allowControl: false)是无结论的,而不是失败的.

萨法里

Safari dev会话与其它引擎在同一座桥上运行:在扩展.js 4.1.21上或更新上, extension_dev 与 browser: "safari" (macOS 有Xcode) 构建应用程序,打开它,在每一个保存上重新加载,并流出它的日志. Safari的MV3背景 CSP块 eval, 没有 CDP 或 RDP 路径 extension_inspect选项卡,打开标签时需要一个 safaridriver 会话;限制列在下面 萨法里。 。 。 .

平台( 私人 α)

13个平台工具连接代理 扩展名.dev在服务器启动前,它们不会被打开 --features=local,platform,并共享、发布、促进和提交需要登录:

npx @extension.dev/mcp login --project <workspace>/<project>

你批准一个代码在 扩展名.dev/device;没有 GitHub 令牌到达您的机器, 而工程范围令牌是存放在当地的, 从未返回代理, 最多活了7天 . extension_preview_web 与 share: true 上传刚刚制作的构件,并返回一个链接,使网页模拟器中的字节与它的 expiresAt (单位:千美元) revokeUrl。 。 。 . extension_publish 返回构建扩展名的可共享 URL。 dev 已经持有; extension_submit 通过扩展发送已建扩展到存储审查 。 dev,它持有你的商店证书, 默认为干线运行.

extension_submit_check 只读或询问的电话 readOnlyHint: true,因此客户端的许可层可以从商店行为中告诉他们:飞行前,状态,默认的干跑,以及每一个批准请求,第一个没有的呼叫 approvalId 不执行,只要求工作空间所有者批准关于扩展的确切法案。 dev( 与 dryRun: false,发布,取消,推出,发布,同步列表中包含平台获得的值,配置存储到提交模式中,将下一次上传发送到发布它的审查. 它从不寄信或信 approvalId 到平台上. extension_submit 使用需要花费批准时间的呼叫, 简单的同步列表或配置存储, 立即写入, 以及所有其他商店的行为, 因此它带有破坏性提示; 它仍然接受读取的呼叫 。 如果你也接受批准页作为这些行为的唯一大门, 允许两个工具的名字,在克洛德代码的 .claude/settings.json数字 :

{ "permissions": { "allow": ["mcp__extension-dev__extension_submit_check", "mcp__extension-dev__extension_submit"] } }
Chrome Web StoreFirefox Add-onsEdge Add-onsApp Store
Chrome 网页存储器Firefox 添加点数边缘加进应用程序存储

对项目建设分支的推动,仅在项目根目录下更改文件时,才会花费一个平台建设;对另一个分支的推动,一个只更改外部文件或许可证文件 public/,或者一个谁的头 承诺说 [skip build] (或 [skip ci],或携带 Extension-Build: skip 拖车在自己的线路上)无所花费 extension_builds 列出每个跳过推及其结果, SKIP_REQUESTED 最后一个. extension_workspace 读取过滤器读取的备忘和分支和根目录.

一些项目的详情、批准流程和批次登录情况如下: 共享在建工程, (中文(简体) ), 未提交出版物 财务报告和审定财务报表 登录。 。 。 .

社区

许可证

Apache-2.0(c) 2026 Cezar Augusto and the extension.dev合作者. 见 自由主义。 。 。 .

版本与发布记录

@extension.dev/mcp 共发布 84 个版本,首次发布于 2026/05/28;过去 12 个月发布了 84 个版本。

版本发布日期距今
10.22.0latest2026/11/095 天前
10.21.02026/11/058 天前
10.20.02026/11/059 天前
10.15.12026/10/2024 天前
10.15.02026/10/2025 天前
10.14.12026/10/1826 天前

其他发布通道:canary → 3.17.0-canary.1779910200.ddcd9eb。

关于 @extension.dev/mcp 的常见问题

@extension.dev/mcp 是什么?

允许AI代理的MCP服务器(Claude Code, Claude Desktop, Cursor, Copilot, Codex)构建,运行,检查并发布浏览器扩展. 38个工具用于脚手架、现场DOM检查、日志流和Chrome、Edge、Firefox、Sa等地的储存准备建造

如何安装 @extension.dev/mcp?

在项目目录运行 npm install @extension.dev/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 extension-mcp,可以用 npx extension-mcp 直接运行。

@extension.dev/mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@extension.dev/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@extension.dev/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@extension.dev/mcp 可以商用吗?

@extension.dev/mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@extension.dev/mcp 的下载量有多少?

根据 npm 官方下载统计,@extension.dev/mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,651 次,日均约 88 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@extension.dev/mcp 还在维护吗?

最新版本 10.22.0 发布于 2026/11/09(5 天前);至今共发布 84 个版本,其中过去 12 个月发布了 84 个;首次发布于 2026/05/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。