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.