Primp MCP Server

Primp MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso à biblioteca de cliente HTTP primp com capacidades de personificação de navegador.

Recursos

• Personificação de Navegador: Personifique vários navegadores (Chrome, Firefox, Safari, Edge) e sistemas operacionais
• Métodos HTTP: Suporte para GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
• Autenticação: Suporte a autenticação básica e token Bearer
• Suporte a Proxy: Suporte a proxy HTTP/HTTPS
• Upload de Arquivos: Upload de arquivos com dados de formulário multipart
• Formatos de Resposta: Retorne respostas como texto, JSON, markdown, texto simples ou texto rico
• Opções Avançadas: Timeouts configuráveis, tratamento de redirecionamento, verificação SSL

Instalação

pip install -e .

Uso

O servidor fornece duas ferramentas principais:

1. primp_request

Faça requisições HTTP com personificação de navegador (nota, estas instruções são para o 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

Faça upload de arquivos usando dados de formulário multipart:

# 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"
        }
    }
}

Configuração

Adicione às suas configurações MCP:

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

Navegadores Suportados

• Chrome (versões 99-131)
• Firefox (versões 99-133)
• Safari (versões 12-18, incluindo iPad/iPhone)
• Edge (versões 99-131)
• OkHttp (versões 3.14.9-5.0.0)

Sistemas Operacionais Suportados

• Windows
• macOS
• Linux
• Android
• iOS

Licença

MIT