ProxyPin MCP Server

ProxyPin MCP Server is based on the Model Context Protocol (MCP). It works with the open source project ProxyPin to expose your local capture history to MCP-capable clients.

Docs: English | 中文

Features

• Read local ProxyPin history (HAR)
• List/search/detail tools for captured requests
• API structure analysis and code generation
• Works with mainstream MCP clients (Windsurf / Cursor / Claude Desktop / Codex)

Prerequisites

1. Install and open ProxyPin
2. In ProxyPin History settings, enable “Cache Date” (required)
3. Ensure some capture history exists
4. Node.js (for npx) and uv (for uvx)

Installation

Run with npx

npx -y @elonjask/proxypin-mcp@latest

Usage

Add the following configuration to your MCP client configuration file:

{
  "mcpServers": {
    "proxypin": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@elonjask/proxypin-mcp@latest"]
    }
  }
}

[!TIP] If your client does not support type, remove the field.

Environment Variables

Variable	Description	Default
PROXYPIN_DATA_DIR	ProxyPin history directory	auto-detect
PROXYPIN_HAR_LIMIT	max HAR files scanned	50
PROXYPIN_MAX_BODY_SIZE	max body bytes kept	102400

Available Tools

list_requests

List recent captured requests.

Parameters:

• limit (int, optional, default 20)
• detail (string: summary | key | full)
• domain (string, optional)
• method (string, optional)
• status (int, optional)

get_request

Get a single request detail by ID.

Parameters:

• request_id (string, required)
• include_body (boolean, optional, default true)

search_requests

Search requests by keyword.

Parameters:

• keyword (string, required)
• search_in (string: all | url | request_body | response_body)
• limit (int, optional, default 20)

analyze_api

Analyze API structure for a domain.

Parameters:

• domain (string, required)

get_domains

List captured domains with counts.

Parameters:

• none

generate_code

Generate API call code from a captured request.

Parameters:

• request_id (string, required)
• language (string: python | javascript | typescript | curl)
• framework (string: requests | httpx | fetch | axios)

License

This project is licensed under the MIT License.