powhttp-mcp

powhttp-mcp

Um servidor MCP que dá aos assistentes de IA visão de raio-X sobre o tráfego HTTP capturado pelo powhttp.

Veja em ação

Usando /generate_scraper para construir um monitor de listagens de carros BMW:

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

Recursos

• Análise de Tráfego HTTP - Pesquise, inspecione e analise requisições/respostas HTTP capturadas
• Detecção Anti-Bot - Compare tráfego de navegador vs. programático para identificar vetores de detecção
• Fingerprinting - Gere impressões digitais TLS (JA3/JA4) e HTTP/2
• Mapeamento de API - Agrupe e catalogue endpoints de API a partir do tráfego capturado
• Análise GraphQL - Agrupe operações, inspecione esquemas e extraia erros de APIs GraphQL
• Inferência de Esquema - Infira esquemas mesclados de múltiplos corpos de resposta com estatísticas de campos
• Rastreamento de Fluxo - Rastreie requisições relacionadas (redirecionamentos, chamadas dependentes)
• Validação de Esquema - Valide corpos de resposta contra structs Go, Zod ou JSON Schema
• Geração de Scrapers - Gere scrapers Go de prova de conceito a partir do tráfego capturado

Validação de esquema em ação - corrigindo estruturas de dados para casos extremos:

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

Instalação

Instale via go install:

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

Ou instale uma versão 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 a API de Dados

Antes de usar o powhttp-mcp, você precisa habilitar a API de Dados no powhttp:

1. Abra Configurações do Powhttp > API de Dados
2. Certifique-se de que a API de Dados está em execução
3. (Recomendado) Habilite Início automático ao abrir o aplicativo para conveniência
4. Anote o número da porta — você precisará dele para POWHTTP_BASE_URL na sua configuração MCP

Uso

Conectando ao Cursor

Adicione ao seu .cursor/mcp.json:

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

Conectando ao Claude Desktop

Adicione à configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

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

Conectando ao Claude Code

Adicione usando a CLI:

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

O scraper gerado executando com sucesso:

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

Prompts MCP

O powhttp-mcp fornece 4 prompts para fluxos de trabalho guiados:

Ferramentas MCP

O powhttp-mcp fornece 17 ferramentas para análise de tráfego HTTP:

Veja internal/mcp/README.md para documentação detalhada das ferramentas.

Variáveis de Ambiente

Desenvolvimento

Pré-requisitos

• Go 1.24.5 ou posterior
• Instância powhttp em execução

Compilação

go build ./cmd/powhttp-mcp

Testes

go test ./...

Solicitações de Recursos e Relatórios de Bugs

Tem uma sugestão de recurso ou encontrou um bug? Adoraríamos ouvir de você!

• Solicitações de Recursos: Abra uma issue com o rótulo enhancement
• Relatórios de Bugs: Inclua etapas para reproduzir, detalhes do seu ambiente e logs relevantes

Contribuindo

Usamos squash merges para todos os pull requests. Ao criar um PR, certifique-se de que o título do PR segue o formato Conventional Commits, pois ele se tornará a mensagem do commit:

Dispara lançamento:

• feat: - incremento de versão menor
• fix: - incremento de versão de patch
• perf: - incremento de versão de patch
• revert: - incremento de versão de patch
• feat!: ou BREAKING CHANGE: - incremento de versão principal

Sem lançamento:

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

O versionamento é automatizado via release-please.

Licença

Este projeto é licenciado sob a GNU Affero General Public License v3.0 - veja o arquivo LICENSE para detalhes.

Agradecimentos

Sobre a String — String (site melhor em breve :) ) extrai dados estruturados de qualquer site em escala. Cuidamos de todo o código e manutenção.

Este projeto foi construído durante um hackathon interno focado em ferramentas de experiência do desenvolvedor. Agradecimentos especiais a:

• Kashif Ghafoor — Por suas contribuições durante o hackathon
• Florian — Criador do powhttp por implementar a API a partir de uma sugestão e ser receptivo ao feedback

Projetos Relacionados

• powhttp - Captura e análise de tráfego HTTP
• Model Context Protocol - Especificação do protocolo