FileForge Browser DevTools

io.github.mayank1307由 GitHub 账号 mayank1307 发布v0.2.2更新于 Nov 5, 2026

Browser DevTools for agents in your signed-in Chrome: cross-tab watching, route sweeps, bug reports.

已验证STDIO仅桌面浏览器自动化开发者工具安全与监控

概览

AI 生成的概览

本地 MCP 服务器加 Chrome 扩展，让助手在你已登录的浏览器中跨标签页监视、遍历路由并生成缺陷报告。

可以做什么
  • 控制浏览器标签页、读取页面状态，并与 DOM 交互（点击、填写、断言）
  • 抓取页面、提取表格与元数据，并搜索已保存页面、结果、笔记、历史记录和书签
  • 运行 QA 冒烟测试、无障碍、响应式与性能审计，捕获并比较视觉产物
  • 检查 DevTools 会话、网络与 API 调用、应用框架状态以及 Chrome 扩展信息
  • 录制并运行浏览器工作流配方、例程与定时任务
  • 生成缺陷报告、PR 证据包，并导出结果、HAR 文件或 SQL 查询输出
适用场景
适合需要助手在真实且已登录的 Chrome 会话中操作的场景：复现并记录缺陷、遍历站点路由做 QA、无障碍或响应式检查，以及为报告或拉取请求整理证据。
运行要求
需要 Node.js 20 或更高版本，以及同一台桌面电脑上的 Google Chrome。需全局安装 npm 包（不要用 npx），以保证随包附带的 Chrome 扩展目录位置不变；在开发者模式下以未打包方式加载扩展，并在 MCP 客户端中注册服务器。可选的配对模式使用 FILEFORGE_REQUIRE_PAIRING 环境变量和配对命令生成的桥接令牌。
安装前请注意
助手会在你已登录的 Chrome 配置中操作，因此可访问这些会话能触及的内容，包括需登录的页面和已存数据。它可以点击、填写和跳转页面，运行和删除工作流配方，并写入本地笔记、记忆和已存结果。配对默认关闭，建议开启。仅限桌面端，无网页版。

安装

在 SourceWeft 中

  1. 打开 控制台中的 FileForge Browser DevTools，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

fileforge-mcp-server

The MCP server for FileForge. Your agent watches your signed-in Chrome across tabs, sweeps your routes, and hands you the bug report. This package also contains the FileForge Chrome extension, which you load unpacked from the package folder.

You need Node.js 20 or newer and Google Chrome.

Install

bash
npm install -g fileforge-mcp-server

Install it globally, not with npx: Chrome loads the extension from the package folder, so the folder must stay put.

Set it up

bash
fileforge-setup

This prints the extension folder and the exact command or config for each MCP client, using your real paths. It changes nothing unless you pass --write.

Open chrome://extensions, turn on Developer mode, click Load unpacked and pick the folder it printed. The card should show ID nlcebipkdgecilmgfpobamljieanadpn.

Then connect your client. For Claude Code or Codex, run the command it printed. For Cursor or Claude Desktop, let it edit the config file; it keeps your other servers and saves the old file as .bak:

bash
fileforge-setup --client cursor --write

Every client is covered in the setup guide.

Verify

With your MCP client open and Chrome running:

bash
fileforge-verify

Then ask your agent to call fileforge_runtime_action with action: "status".

Pairing

Optional: with FILEFORGE_REQUIRE_PAIRING=1 in the server's environment, the extension must present the bridge token. fileforge-pair prints it, and you paste it into the side panel's Settings tab. See the setup guide.

Updating

bash
npm install -g fileforge-mcp-server@latest

Then click the reload icon on the FileForge card at chrome://extensions and restart your MCP client. fileforge-verify warns when Chrome is still running the old extension code.

More

MIT license.

来源：mcp-server/README.md，提交 648f8d2

工具

26

fileforge_runtime_action

Runtime health, status, capabilities, and request log actions.

输入参数limitaction必填failuresOnlyincludeDetails

fileforge_result_action

Retrieve, list, search, and slice stored FileForge results.

输入参数reflimitqueryaction必填offsetproject

fileforge_browser_action

Control browser tabs and read browser state. Use query_context to read state; navigate/history/wait for tab control.

输入参数urlquerystoretabIduntilaction必填activedryRunidleMsnewTabpresetproject另有 14 个

fileforge_page_interaction

Interact with the DOM, extract page info, run QA checks, and debug failures (click, fill, assert, smoke_test, debug_clickability, capture_debug_bundle, etc.)

输入参数modedepthstoretabIdvalueaction必填amountchecksincludeprojectfallbackselector另有 20 个

fileforge_scrape_action

Scrape and extract content via the GraphQL-style query_scrape action, plus legacy actions (scrape_page, extract_tables, extract_metadata, …).

输入参数urlurlsquerystoretabIdaction必填presetsourcetabIdsprojectmaxPagessections另有 2 个

fileforge_sql_action

List, describe, query, and export SQL-backed FileForge data.

输入参数reflimitquerytableaction必填formatoffsetfilename

fileforge_search_action

Search across saved pages, results, notes, browser history, and bookmarks.

输入参数reflimitqueryaction必填

fileforge_devtools_action

Unified DevTools tool. Primary action: query_devtools (GraphQL-feel modules + presets). Plus session lifecycle, evaluate, replay_request, export_har, and legacy get_* read actions.

输入参数querystoretabIdaction必填dryRunfilterlevelspresetfilenameoperationoverridesrequestId另有 7 个

fileforge_perf_action

Run performance audits and collect metrics.

输入参数url必填storeaction必填projectsettleMstimeoutMsviewportsnetworkIdleMsincludeScreenshotnetworkIdleTimeoutMs

fileforge_qa_testing

Run QA checks, smoke tests, element watches, and route tests.

输入参数urlstoretabIdaction必填checksroutesbaseUrlprojectwatchIdselectortimeoutMsviewports

fileforge_audit_action

Unified audit tool. Primary action: query_audit (GraphQL-feel modules + presets). Also: compare_audit_snapshots, plus legacy route/content/policy/security/recommendation/comparison/export/summary actions.

输入参数keyrefurltextquerystoretabIdtitleaction必填issuespresetroutes另有 16 个

fileforge_visual_action

Capture, compare, inspect, and export visual browser artifacts.

输入参数xyrefrunurlnamestoretabIdwidthaction必填activeformat另有 21 个

fileforge_a11y_action

Run accessibility audits and checks.

输入参数storetabIdaction必填standard

fileforge_responsive_action

Scan layout and find responsive issues across widths.

输入参数urlstoretabIdaction必填checkswidths

fileforge_api_action

Discover and export REST and GraphQL API calls.

输入参数storetabIdaction必填exportfiltergroupByfilenameincludeBodies

fileforge_coding_action

Capture coding-focused page, route, bug, and article context bundles.

输入参数urlstoretabIdtitleaction必填reloadroutesbaseUrlprojectdomDepthkeepOpensettleMs另有 7 个

fileforge_workflow_action

Record, list, run, export, and delete browser workflow recipes.

输入参数namestepsstoretabIdaction必填formatinputscaptureassertions

fileforge_task_action

Create, run, schedule, plan, inspect, validate, dry-run, and export FileForge routines (and legacy task pipelines).

输入参数urlmodenametaskhintslimitpatchqueryrunIdsincestepsstore另有 56 个

fileforge_memory_action

Manage local page memory, diffing, and result slicing.

输入参数refurllimitquerystoretabIdaction必填offsetprojectquestion

fileforge_app_action

Inspect app framework, routing, client storage, feature flags, and framework-specific state.

输入参数tabIdaction必填includeStateHints

fileforge_file_action

Fetch, parse, convert, inspect, and decode files and Data URIs.

输入参数torunurlfromnamelimitstoretabIdaction必填formatdataUriproject另有 3 个

fileforge_note_action

Create, list, and search local notes.

输入参数tagurlbodytagslimitquerytitleaction必填offset

fileforge_report_action

Generate bug reports, PR evidence bundles, and full debug bundles.

输入参数urlstabIdtitleaction必填formatinclude

fileforge_export_action

Export stored results and SQL query output.

输入参数refqueryaction必填formatfilename

fileforge_extension_action

Inspect and test Chrome extension manifest, permissions, storage, service worker, injection, and errors.

输入参数keyareastoretabIdaction必填projectselectors

fileforge_eye_action

God's Eye — cross-tab browser monitoring. Watch chosen tabs, or every open tab with all: true: live network traffic, console errors, JS exceptions, DOM mutations, WebSocket frames. Lock onto a target tab for enhanced capture (auto-screenshots on errors). Plant tripwires that fire silently when conditions hit any tab.

输入参数allurltabsurlsclearlimittabIdaction必填filterenabledfocusedidentity另有 3 个

版本历史

1
  1. v0.2.2最新Nov 5, 2026

评分

已满足适用检查项的 90%

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

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

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

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分