Primp MCP Server

Servidor MCP Primp

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la librería de cliente HTTP primp con capacidades de suplantación de navegador.

Características

• Suplantación de Navegador: Suplanta varios navegadores (Chrome, Firefox, Safari, Edge) y sistemas operativos
• Métodos HTTP: Soporte para GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
• Autenticación: Soporte de autenticación básica y tokens Bearer
• Soporte de Proxy: Soporte de proxy HTTP/HTTPS
• Subida de Archivos: Subida de archivos mediante datos de formulario multipart
• Formatos de Respuesta: Devuelve respuestas como texto, JSON, markdown, texto plano o texto enriquecido
• Opciones Avanzadas: Tiempos de espera configurables, manejo de redirecciones, verificación SSL

Instalación

pip install -e .

Uso

El servidor proporciona dos herramientas principales:

1. primp_request

Realiza solicitudes HTTP con suplantación de navegador (nota: estas instrucciones son para el 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

Sube archivos usando datos de formulario 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"
        }
    }
}

Configuración

Añade a tu configuración de MCP:

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

Navegadores Soportados

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

Sistemas Operativos Soportados

• Windows
• macOS
• Linux
• Android
• iOS

Licencia

MIT