README.md
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.
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
- Install and open ProxyPin
- In ProxyPin History settings, enable “Cache Date” (required)
- Ensure some capture history exists
- Node.js (for
npx) anduv(launcher supports bothuvxanduv tool run)
Installation
Run with npx
npx -y proxypin-mcp@latest
The NPX bridge tries uvx first, then automatically falls back to uv tool run.
Usage
Add the following configuration to your MCP client configuration file:
{
"mcpServers": {
"proxypin": {
"type": "stdio",
"command": "npx",
"args": ["-y", "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)
Skills (Tools)
list_requests: list recent HTTP requests with filters.get_request: fetch one request by ID.search_requests: keyword search across URL and body.analyze_api: group endpoint patterns for one domain.get_domains: summarize captured domains and method counts.generate_code: generate Python/JS/cURL snippets from a capture.
Prompts
analyze_api_prompt(domain): guide API structure analysis workflow.debug_request_prompt(request_id): guide request debugging workflow.
Resources
proxypin://requests/recent: recent request summary dataset.proxypin://domains: captured domains summary dataset.
License
This project is licensed under the MIT License.
Tools 6
list_requestsList recent captured requests with optional filtering.get_requestGet a single request detail by ID.search_requestsSearch requests by keyword across URL or body content.analyze_apiAnalyze API structure for a specific domain.get_domainsList captured domains with request counts.generate_codeGenerate API call code from a captured request.Environment Variables
PROXYPIN_DATA_DIRProxyPin history directoryPROXYPIN_HAR_LIMITmax HAR files scannedPROXYPIN_MAX_BODY_SIZEmax body bytes keptTry it
→List the last 10 captured requests to identify recent API calls.
→Search for requests containing the keyword 'auth' in the request body.
→Analyze the API structure for the domain 'api.example.com'.
→Generate Python requests code for the captured request with ID '12345'.
→Show me a summary of all captured domains and their request counts.