项目简介

Web Client Errors MCP是一个专门用于检测和分析网站客户端错误的Model Context Protocol服务器。它利用浏览器自动化技术（如Playwright）模拟用户访问网页，捕获JavaScript错误、网络请求失败、控制台警告等，并将这些错误进行分类、分析，甚至生成修复建议。通过标准化的MCP接口，它可以无缝集成到LLM应用中，使AI代理能够理解并解决复杂的网页客户端问题。

主要功能点

网页错误检测: 自动访问指定URL，监控并捕获网页加载过程中出现的JavaScript错误、网络请求错误、资源加载失败和控制台警告。
会话管理: 为每次错误检测创建一个会话，记录所有发现的错误及相关上下文信息。
错误分析: 对收集到的错误进行模式识别、常见错误统计和严重性分类。
详细错误信息查询: 提供按错误ID或关键词查询特定错误详情的功能，包括堆栈跟踪和上下文分析。
AI辅助建议: 生成针对特定错误类型的修复建议，帮助开发人员或AI代理快速定位并解决问题。
数据资源: 提供最近错误列表和聚合错误统计数据作为可访问的MCP资源。

安装步骤

在您的机器上，按照以下步骤安装并构建Web Client Errors MCP服务器：

# 克隆仓库
git clone https://github.com/LarsArtmann/web-client-errors-mcp.git
cd web-client-errors-mcp

# 安装依赖（需要Node.js环境和Bun包管理器）
bun install

# 构建项目
bun run build

服务器配置

此MCP服务器通过Stdio协议与客户端通信。您需要将以下配置添加到您的MCP客户端（例如CRUSH的'.mcp.json'文件）中，以便客户端能够发现并连接到此服务器：

{
  "mcp": {
    "web-client-errors": {
      "type": "stdio",
      "command": "/Users/larsartmann/.bun/bin/bun",
      "args": [
        "run",
        "/path/to/web-client-errors-mcp/dist/index.js"
      ],
      "disabled": false
    }
  }
}

'web-client-errors': 服务器的唯一标识名称。
'type': 连接协议类型，此处为'stdio'（标准输入输出）。
'command': 启动MCP服务器的可执行文件路径。请替换为您的'bun'安装路径。
'args': 传递给'command'的参数，用于启动服务器的主入口点。请将'/path/to/web-client-errors-mcp/dist/index.js'替换为实际的构建后文件路径。
'disabled': 是否禁用此服务器，'false'表示启用。

基本使用方法

连接到MCP客户端后，您可以通过调用以下工具来使用此服务器的功能：

检测网站错误:

"detect errors on https://example.com with 10 second wait"

这会启动一个浏览器会话，访问'https://example.com'并等待10秒，捕获期间发生的所有客户端错误。

分析会话中的错误:
```
"analyze error session abc-123"
```
其中'abc-123'是您从'detect errors'工具返回的会话ID。这将对该会话中的错误进行汇总分析。
获取特定错误详情:
```
"get details for TypeError undefined property"
```
这会根据错误消息片段或错误ID来查询并返回该错误的详细信息，包括堆栈跟踪和潜在的修复建议。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息