网络请求查询工具

一款Chrome扩展和MCP服务器,允许AI按需查询网络流量,而非接收所有请求数据,适用于开发调试和API分析。

  • by benjamin-steurer
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 benjamin-steurer/chrome-network-mcp-server

使用说明

Chrome网络MCP服务器

Chrome内置的DevTools MCP会将每个网络请求转储到AI的上下文窗口中。一个繁忙的页面有500多个请求,其中大多数是你不关心的脚本、字体和跟踪像素。在你到达一个重要的API调用之前,你的上下文充满了噪音。

这是一个Chrome扩展程序+ 主控程序 服务器,让你的AI 怎么翻译 网络流量,而不是淹没在其中。按URL、状态代码、资源类型过滤。跨选项卡搜索。只为您实际需要的请求拉取标头和正文。

“把所有东西都扔掉”的问题

我构建这个是因为原生Chrome DevTools集成一直在吹我的上下文窗口。我会让Claude“检查这个API调用失败的原因”,它会获取兆字节的网络数据,烧穿上下文,仍然会错过埋在300位置的相关请求。

解决方法:不要发送所有内容。让AI一步步深入。

→ list_recorded_tabs                              # 3 tabs, 847 requests total

→ get_traffic_summary (types=[XHR, Fetch])        # 12 unique API endpoints, grouped by path

→ get_requests_overview (urlPattern=/api/orders)   # 6 matching requests with status codes

→ get_request_detail (requestId=...)               # full headers + body for the one that matters

大约8KB的上下文,而不是500KB+。人工智能在4个电话中找到它需要的东西,而不是从一堆文本中猜测。

如何比较

Chrome DevTools MCP 此
上下文用法 一次处理所有内容 只处理请求的内容
筛选 基本 正则表达式、资源类型、状态代码、排除模式
跨选项卡 否 一次搜索所有选项卡
响应体 全部或无 截断、跳过或获取每个请求
截断 无声 明确警告AI,以便它知道获取更多信息

设置

1.安装服务器

cd server && npm install

2.加载Chrome扩展程序

首选 chrome://extensions,启用开发人员模式,单击“加载解包”,选择 extension/ 文件夹。

3.配置您的MCP客户端

复制 .mcp.json.example 到 .mcp.json 在您的项目中,更新路径:

{
  "mcpServers": {
    "chrome-network": {
      "command": "node",
      "args": ["/absolute/path/to/server/index.mjs"]
    }
  }
}

4.记录流量

单击扩展图标,点击开始录制。它捕获所有标签页的流量。停止记录保留数据以供查询;Stop&Clear会擦除它。

工具

工具 它做什么
list_recorded_tabs 哪些选项卡有流量,每个选项卡有多少请求
get_requests_overview 选项卡的筛选请求列表——方法、URL、状态、大小(无正文)
get_request_detail 单个请求的完整标头、正文和时间
get_traffic_summary 按域或路径分组的请求——查看页面与哪些API对话
search_requests 按URL模式、方法或状态在所有选项卡中查找请求
start_recording / stop_recording 来自AI的控制记录
get_recording_status 检查连接和录制状态
clear_recordings 擦除存储的数据(全部或每个选项卡)

所有列表工具都支持分页。当结果被截断时,响应中会包含一个明确的警告,这样AI就不会认为它看到了一切。

配置

Env变量 默认值 它的作用
WS_PORT 7890 扩展端口↔ 服务器WebSocket
RECORDING_TTL_MINUTES 30 几分钟后自动清理过时数据

该端口也可以从扩展弹出窗口进行配置。

运作原理

Chrome Extension  ──WebSocket──►  MCP Server  ──stdio──►  Claude Code

该扩展使用 chrome.debugger (不是 webRequest)以捕获完整的请求和响应正文。它通过localhost WebSocket将所有内容流式传输到MCP服务器,MCP服务器将其存储在内存中,并通过stdio上的MCP工具公开。

每个标签页的请求上限为5000,响应体上限为1MB,以保持内存限制。配置TTL后数据自动过期。

安全

  • 捕获 全部 录制时包括身份验证标头和Cookie在内的流量——请注意您正在录制的内容
  • WebSocket绑定到 127.0.0.1 仅
  • 这 <all_urls> 需要主机权限 chrome.debugger 附加到任何选项卡

需求

许可证

麻省理工学院