Primp MCP Server

Một máy chủ MCP cho trình khách HTTP Primp, cho phép mạo danh trình duyệt cho các yêu cầu và tải lên tệp tin.

GitHub

Tài liệu

Primp MCP Server

A Model Context Protocol (MCP) server that provides access to the primp HTTP client library with browser impersonation capabilities.

Features

  • Browser Impersonation: Impersonate various browsers (Chrome, Firefox, Safari, Edge) and operating systems
  • HTTP Methods: Support for GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
  • Authentication: Basic auth and Bearer token support
  • Proxy Support: HTTP/HTTPS proxy support
  • File Uploads: Multipart form data file uploads
  • Response Formats: Return responses as text, JSON, markdown, plain text, or rich text
  • Advanced Options: Configurable timeouts, redirect handling, SSL verification

Installation

pip install -e .

Usage

The server provides two main tools:

1. primp_request

Make HTTP requests with browser impersonation (note, these instructions are for the LLM):

# Example usage in MCP client
{
    "name": "primp_request",
    "arguments": {
        "url": "https://httpbin.org/get",
        "method": "GET",
        "impersonate": "chrome_131",
        "impersonate_os": "windows",
        "headers": {
            "User-Agent": "My-App/1.0"
        },
        "return_format": "json"
    }
}

2. primp_upload

Upload files using multipart form data:

# Example usage in MCP client
{
    "name": "primp_upload",
    "arguments": {
        "url": "https://httpbin.org/post",
        "files": [
            {
                "name": "file",
                "filename": "example.txt",
                "content": "SGVsbG8gV29ybGQ=",  # base64 encoded
                "content_type": "text/plain"
            }
        ],
        "data": {
            "description": "Test upload"
        }
    }
}

Configuration

Add to your MCP settings:

{
  "mcpServers": {
    "primp": {
      "command": "primp-mcp"
    }
  }
}

Supported Browsers

  • Chrome (versions 99-131)
  • Firefox (versions 99-133)
  • Safari (versions 12-18, including iPad/iPhone)
  • Edge (versions 99-131)
  • OkHttp (versions 3.14.9-5.0.0)

Supported Operating Systems

  • Windows
  • macOS
  • Linux
  • Android
  • iOS

License

MIT