HAR MCP Server

HAR MCP 服务

一个用于解析和分析 HAR（HTTP Archive）文件的 Model Context Protocol (MCP) 服务。此服务支持 AI 助手检查以 HAR 格式捕获的网络流量，并内置敏感身份验证标头的脱敏功能。

功能

• 从本地文件系统或 HTTP URL 加载 HAR 文件
• 列出 HAR 文件中访问的所有 URL 和 HTTP 方法
• 查询特定 URL 和方法组合对应的请求 ID
• 获取完整请求详情，并自动对身份验证标头进行脱敏
• 灵活解析 HAR，能够处理真实场景中的 HAR 文件，包括：
  • 时间字段中的浮点数／小数值（自动四舍五入为整数）
  • 纯文本或 Base64 编码的响应内容
  • 基本 HAR 规范中未包含的其他字段
• 支持浏览器开发者工具生成的标准 HAR 格式

安装

你可以使用标准的 MCP 配置安装此 MCP 服务。

将以下 JSON 块添加到你的 MCP 配置中。

使用 docker

{
  "mcp": {
    "servers": {
      "har": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "ghcr.io/tjamet/har-mcp"
        ]
      }
    }
  }
}

使用 go run

你也可以直接使用 go run 运行此服务。

{
  "mcpServers": {
    "github": {
      "command": "go",
      "args": [
        "run",
        "github.com/tjamet/har-mcp/cmd/har-mcp@main"
      ]
    }
  }
}

从源代码构建

如果没有 Docker，可以使用 go build 在 cmd/har-mcp 目录中构建二进制文件，并使用 github-mcp-server 命令。 如需指定构建输出位置，请使用 -o 标志。你应将服务配置为使用构建好的可执行文件作为其 command。例如：

{
  "mcp": {
    "servers": {
      "github": {
        "command": "/path/to/har-mcp-server"
      }
    }
  }
}

用法

HAR MCP 服务以基于 stdio 的 MCP 服务形式运行，通过标准输入／输出使用 JSON-RPC 进行通信。

运行服务

./har-mcp

可用工具

1. load_har

从文件路径或 HTTP URL 加载 HAR 文件。

参数：

• source（字符串，必需）：HAR 文件的路径或 HTTP URL

示例：

{
  "source": "/path/to/capture.har"
}

2. list_urls_methods

列出已加载 HAR 文件中访问的所有 URL 及其 HTTP 方法。

**参数：**无

**返回：**包含 URL／方法组合及其关联请求 ID 的数组。

3. get_request_ids

获取特定 URL 和 HTTP 方法对应的所有请求 ID。

参数：

• url（字符串，必需）：用于筛选的 URL
• method（字符串，必需）：用于筛选的 HTTP 方法（GET、POST 等）

示例：

{
  "url": "https://api.example.com/users",
  "method": "GET"
}

4. get_request_details

根据请求 ID 获取完整的请求详情。身份验证标头将自动脱敏。

参数：

• request_id（字符串，必需）：要获取详情的请求 ID

示例：

{
  "request_id": "request_0"
}

已脱敏的标头：

• Authorization
• X-API-Key
• X-Auth-Token
• Cookie
• Set-Cookie
• Proxy-Authorization

与 Claude Desktop 集成

将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "har-mcp": {
      "command": "/path/to/har-mcp"
    }
  }
}

开发

运行测试

go test ./...

项目结构

.
├── cmd/
│   └── har-mcp/       # Main application
│       └── main.go
├── pkg/
│   └── har/           # HAR parsing library
│       ├── parser.go
│       └── parser_test.go
├── go.mod
├── go.sum
└── README.md

依赖项

• github.com/google/martian/har - HAR 文件解析
• github.com/mark3labs/mcp-go - MCP 服务实现
• github.com/stretchr/testify - 测试断言

许可证

[在此添加许可证]