HAR MCP 服务器

这是一个用于解析和分析 HAR（HTTP Archive）文件的 模型上下文协议（MCP） 服务器。此服务器允许AI助手检查以HAR格式捕获的网络流量，并内置支持删除敏感的身份验证头。

特性

• 从本地文件系统或HTTP URL加载HAR文件
• 列出HAR文件中访问的所有URL和HTTP方法
• 查询特定URL和方法组合的请求ID
• 获取完整的请求详情，自动删除身份验证头
• 灵活的HAR解析，处理现实世界的HAR文件：
  • 时间字段的浮点/十进制值（自动四舍五入为整数）
  • 明文或base64编码的响应内容
  • 基本HAR规范之外的附加字段
• 支持由浏览器开发者工具生成的标准HAR格式

安装

您可以使用标准的MCP配置来安装这个MCP服务器。

在您的mcp配置中添加以下JSON块。

使用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服务器作为一个基于标准I/O的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.go
├── pkg/
│   └── har/           # HAR解析库
│       ├── 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 - 测试断言

许可证

[在此处添加您的许可证]