powhttp-mcp

powhttp-mcp

Un servidor MCP que da a los asistentes de IA visión de rayos X sobre el tráfico HTTP capturado por powhttp.

Véalo en acción

Usando /generate_scraper para construir un monitor de listados de autos BMW:

https://github.com/user-attachments/assets/be098e9d-d700-491c-ae7f-5afb12732728

Características

• Análisis de Tráfico HTTP - Busca, inspecciona y analiza solicitudes/respuestas HTTP capturadas
• Detección Anti-Bot - Compara tráfico de navegador vs programático para identificar vectores de detección
• Huellas Digitales - Genera huellas digitales TLS (JA3/JA4) y HTTP/2
• Mapeo de API - Agrupa y cataloga endpoints de API a partir del tráfico capturado
• Análisis GraphQL - Agrupa operaciones, inspecciona esquemas y extrae errores de APIs GraphQL
• Inferencia de Esquemas - Infiere esquemas combinados de múltiples cuerpos de respuesta con estadísticas de campos
• Trazado de Flujo - Rastrea solicitudes relacionadas (redirecciones, llamadas dependientes)
• Validación de Esquemas - Valida cuerpos de respuesta contra structs de Go, Zod o JSON Schema
• Generación de Scrapers - Genera scrapers Go de PoC a partir del tráfico capturado

Validación de esquemas en acción - corrigiendo estructuras de datos para casos límite:

https://github.com/user-attachments/assets/1156c537-70ab-4179-ad4a-c148988ac503

Instalación

Instala vía go install:

go install github.com/usestring/powhttp-mcp/cmd/powhttp-mcp@latest

O instala una versión específica:

go install github.com/usestring/powhttp-mcp/cmd/powhttp-mcp@v1.0.0

go env GOPATH

export PATH="$PATH:$(go env GOPATH)/bin"

export PATH="$PATH:$(go env GOPATH)/bin"

fish_add_path (go env GOPATH)/bin

source ~/.zshrc  # or ~/.bashrc, etc.

$env:PATH += ";$(go env GOPATH)\bin"

[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$(go env GOPATH)\bin", "User")

Habilitando la API de Datos

Antes de usar powhttp-mcp, necesitas habilitar la API de Datos en powhttp:

1. Abre Powhttp Settings > Data API
2. Asegúrate de que la API de Datos esté en ejecución
3. (Recomendado) Habilita Auto start on app launch para mayor comodidad
4. Anota el número de puerto — lo necesitarás para POWHTTP_BASE_URL en tu configuración de MCP

Uso

Conectando a Cursor

Añade a tu .cursor/mcp.json:

{
  "mcpServers": {
    "powhttp": {
      "command": "powhttp-mcp",
      "env": {
        "POWHTTP_BASE_URL": "http://localhost:7777",
        "POWHTTP_PROXY_URL": "http://localhost:8888"
      }
    }
  }
}

Conectando a Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "powhttp": {
      "command": "powhttp-mcp",
      "env": {
        "POWHTTP_BASE_URL": "http://localhost:7777",
        "POWHTTP_PROXY_URL": "http://localhost:8888"
      }
    }
  }
}

Conectando a Claude Code

Añade usando la CLI:

claude mcp add powhttp -e POWHTTP_BASE_URL=http://localhost:7777 -e POWHTTP_PROXY_URL=http://localhost:8888 -- powhttp-mcp

El scraper generado ejecutándose correctamente:

https://github.com/user-attachments/assets/52b30cbf-7c66-40b1-a3fe-9c12d37ece11

Prompts de MCP

powhttp-mcp proporciona 4 prompts para flujos de trabajo guiados:

Herramientas de MCP

powhttp-mcp proporciona 17 herramientas para análisis de tráfico HTTP:

Consulta internal/mcp/README.md para documentación detallada de las herramientas.

Variables de Entorno

Desarrollo

Requisitos previos

• Go 1.24.5 o posterior
• Instancia de powhttp en ejecución

Compilación

go build ./cmd/powhttp-mcp

Pruebas

go test ./...

Solicitudes de Funciones e Informes de Errores

¿Tienes una sugerencia de función o encontraste un error? ¡Nos encantaría saber de ti!

• Solicitudes de Funciones: Abre un issue con la etiqueta enhancement
• Informes de Errores: Por favor incluye pasos para reproducir, detalles de tu entorno y logs relevantes

Contribuciones

Usamos squash merges para todos los pull requests. Al crear un PR, asegúrate de que el título del PR siga el formato de Conventional Commits, ya que se convertirá en el mensaje de commit:

Dispara release:

• feat: - incremento de versión menor
• fix: - incremento de versión patch
• perf: - incremento de versión patch
• revert: - incremento de versión patch
• feat!: o BREAKING CHANGE: - incremento de versión mayor

Sin release:

• docs:, chore:, refactor:, test:, style:, build:, ci:

El versionado se automatiza vía release-please.

Licencia

Este proyecto está licenciado bajo la GNU Affero General Public License v3.0 - consulta el archivo LICENSE para más detalles.

Agradecimientos

About String — String (mejor sitio web próximamente :) ) extrae datos estructurados de cualquier sitio web a escala. Nosotros nos encargamos de todo el código y mantenimiento.

Este proyecto fue construido durante un hackathon interno enfocado en herramientas de experiencia de desarrollador. Agradecimientos especiales a:

• Kashif Ghafoor — Por sus contribuciones durante el hackathon
• Florian — Creador de powhttp por implementar la API a partir de una sugerencia y ser receptivo a los comentarios

Proyectos Relacionados

• powhttp - Captura y análisis de tráfico HTTP
• Model Context Protocol - Especificación del protocolo