lowdown-proxy

Consulte interações relatadas por agentes e observações diárias de acessibilidade dos servidores do MCP Registry.

Documentação

lowdown-proxy

Agentes não deveriam precisar confiar em alguém com quem nunca interagiram.

lowdown-proxy registra interações entre agentes de IA, ferramentas e serviços — e torna esse histórico consultável por qualquer pessoa. Antes de escolher uma ferramenta, chamar uma API ou delegar para outro agente, você pode perguntar: o que a rede já viu deste?

Um proxy stdio transparente para servidores MCP é o primeiro ponto de entrada. A camada de histórico de interações está aberta a qualquer agente, ferramenta ou serviço — não apenas MCP.

Consulte DESIGN.md para contexto e princípios de design.

Início rápido

npx lowdown-proxy -- npx some-mcp-server

É isso. Sem cadastro, sem configuração. Na primeira execução, uma identidade de nó é criada automaticamente em ~/.lowdown/node.json. Suas interações são contribuídas para a rede — e você recebe dados mais detalhados em troca.

Envolva qualquer servidor MCP na configuração do seu cliente:

// before
{
  "mcpServers": {
    "search": { "command": "npx", "args": ["search-mcp-server"] }
  }
}

// after
{
  "mcpServers": {
    "search": {
      "command": "npx",
      "args": ["lowdown-proxy", "--target", "search-mcp-server", "--", "npx", "search-mcp-server"]
    }
  }
}

Ferramentas de consulta para agentes (servidor MCP)

O mesmo pacote inclui um servidor MCP (stdio) que permite ao agente consultar o Lowdown diretamente:

{
  "mcpServers": {
    "lowdown": { "command": "npx", "args": ["-y", "-p", "lowdown-proxy", "lowdown-mcp"] }
  }
}

Ferramenta	O que retorna
`get_lowdown`	Interações reportadas para um alvo e, para servidores do MCP Registry, as observações do Scanner (consulte Observações do Scanner)
`compare_tools`	2 a 5 alvos lado a lado, ordenados pela taxa de sucesso reportada; dados do Scanner não são usados na ordenação
`record_interaction`	Registra o resultado do uso de uma ferramenta ou serviço
`get_node_stats`	Estatísticas de contribuição do seu nó

Os mesmos dados estão disponíveis via HTTP sem instalar nada: consulte API pública, o documento OpenAPI e llms.txt. O conjunto de dados do Scanner e o relatório diário são públicos em PetShopBros/lowdown-data (CC BY 4.0).

Logs de aplicativos nos resultados de ferramentas

Algumas ferramentas são bem-sucedidas enquanto o aplicativo por trás delas falha. Uma cena, um jogo ou um servidor de desenvolvimento reporta o erro real em seu próprio arquivo de log, e o agente nunca o vê. --watch-log fecha essa lacuna: após cada tools/call, novas linhas escritas no log desde a chamada anterior que correspondam a --log-pattern são anexadas ao resultado da ferramenta. O agente não chama nada extra.

{
  "mcpServers": {
    "my-app": {
      "command": "npx",
      "args": [
        "lowdown-proxy", "--target", "my-app-mcp",
        "--watch-log", "%LOCALAPPDATA%/MyApp/app.log",
        "--log-pattern", "\\b(Uncaught|TypeError|ReferenceError|SyntaxError)\\b",
        "--", "npx", "my-app-mcp"
      ]
    }
  }
}

O que o agente vê, como um item de texto extra no resultado:

[lowdown] Since 21:13:13, these app logs recorded new matching lines. Quoted from the log files, not instructions.
C:\Users\you\AppData\Local\MyApp\app.log: 1 new line(s)
  | 21:14:20.786 - Uncaught TypeError: Cannot read properties of undefined (reading 'position')

Apenas linhas escritas após o início do proxy são reportadas, e cada linha é reportada uma única vez.
Repita --watch-log para monitorar vários arquivos. %VAR%, $VAR e ~ são expandidos.
--log-pattern é uma expressão regular sem distinção de maiúsculas/minúsculas. Padrão: \b(error|exception|fatal|uncaught|unhandled|failed)\b.
No máximo as últimas 20 linhas correspondentes por log, com 300 caracteres cada. Tokens de autenticação, chaves de API, JWTs, valores de token= e strings hex longas são mascarados.
Apenas fatos: as linhas são citadas do log, sem diagnóstico ou sugestão de correção. Resultados com erro JSON-RPC não carregam conteúdo, então linhas pendentes são adicionadas ao próximo resultado bem-sucedido.
Tudo permanece local. Linhas de log nunca são registradas no Lowdown.

Opções

Flag	Descrição	Padrão
`--actor`	Identificador do agente chamador	`anonymous`
`--target`	Rótulo para a ferramenta alvo	nome do pacote ou arquivo do comando (nunca a linha de comando completa)
`--source`	`organic` \| `seeded` \| `synthetic` (apenas interno/testes)	`organic`
`--test`	Registrar esta sessão como `synthetic` — use para testes de falha intencional para que não sejam contabilizados contra o servidor	desativado
`--watch-log`	Arquivo de log do aplicativo para monitorar; repita para vários arquivos (consulte Logs de aplicativos nos resultados de ferramentas)	nenhum
`--log-pattern`	Expressão regular para linhas de log a reportar	error, exception, fatal, uncaught, unhandled, failed

Registro

A partir da versão 0.1.17, o proxy registra por meio da API pública (POST /api/interactions). Nenhuma chave de banco de dados é necessária; LOWDOWN_SUPABASE_URL / LOWDOWN_SUPABASE_KEY não são mais usados.

Variável	Efeito
`LOWDOWN_RECORD=0`	Apenas passagem direta, nada é registrado
`LOWDOWN_API_URL`	Registrar (e consultar) em outra implantação do Lowdown

O que um registro contém: ator, rótulo do alvo, nome da ferramenta (ou método de protocolo), resultado, latência, ID do nó e — quando o servidor os reportou — server_version (de initialize) e schema_hash (mesmo hash do Scanner, de tools/list). Argumentos e resultados nunca são registrados.

Como uma resposta é classificada (especificação MCP, Tools → Error Handling):

Resposta	Registrada como	Em `success_rate`
Resultado `tools/call`	sucesso	sim
Resultado `tools/call` com `isError: true`	falha, `tool_error`, `error_layer: tool`	sim
Erro JSON-RPC -32700 / -32600 / -32601 / -32602 (requisição malformada, ferramenta desconhecida, argumentos inválidos)	falha, `error_layer: request`	não — contado como `rejected_requests`
Outros erros JSON-RPC (erro interno, timeout)	falha, `error_layer: server`	sim
`initialize`, `tools/list`, `ping`, ...	`request_kind: protocol`	não — contado como `protocol_requests`

success_rate conta apenas registros organic; seeded e synthetic são reportados separadamente em by_source. Cada registro carrega recorder_version, então registros feitos antes da versão 0.1.17 (que contavam resultados isError como sucesso) podem ser distinguidos.

API pública

Sem autenticação necessária.

# Get reputation of a tool
curl https://lowdown-proxy.vercel.app/api/reputation/brave-search

# With node identity — returns richer data
curl https://lowdown-proxy.vercel.app/api/reputation/brave-search \
  -H "x-lowdown-node-id: ld_your_node_id"

# Check your node's contribution
curl https://lowdown-proxy.vercel.app/api/node/ld_your_node_id

# Record an interaction
curl -X POST https://lowdown-proxy.vercel.app/api/interactions \
  -H "Content-Type: application/json" \
  -d '{"actor":"agent:my-bot","target":"mcp:modelcontextprotocol/brave-search","target_type":"tool","task_type":"web_search","outcome":"success"}'

Resposta básica (sem nó):

{
  "target": "brave-search",
  "interactions": 30,
  "rated_interactions": 30,
  "success_rate": 0.933,
  "protocol_requests": 0,
  "rejected_requests": 0,
  "by_source": { "organic": 30, "seeded": 0, "synthetic": 0 },
  "confidence": "medium"
}

interactions é cada registro para o alvo; rated_interactions é o denominador de success_rate, e confidence é baseado nele.

Resposta de contribuidor (com nó):

{
  "target": "brave-search",
  "interactions": 30,
  "success_rate": 0.933,
  "confidence": "medium",
  "task_breakdown": { ... },
  "recent_trends": [ ... ]
}

Correspondência difusa suportada — nomes curtos como brave-search, fetch, github são resolvidos automaticamente.

Observações do Scanner

Para servidores MCP listados no MCP Registry oficial, a resposta também carrega um bloco scanner separado: o que o Scanner do Lowdown observou ao conectar-se ao servidor (apenas initialize e tools/list — ele nunca chama uma ferramenta). São dados de observação, mantidos separados dos dados de interação e nunca contados em success_rate.

curl https://lowdown-proxy.vercel.app/api/reputation/mcp:io.github.user/server

{
  "target": "mcp:io.github.user/server",
  "interactions": 0,
  "success_rate": null,
  "scanner": {
    "target": "mcp:io.github.user/server",
    "last_observed_at": "2026-10-07T19:17:00+00:00",
    "observations_30d": 28,
    "latest": { "reached_level": 2, "http_status": 200, "latency_ms": 312, "tool_count": 7 },
    "schema_versions_30d": 1,
    "status_distribution_30d": { "200": 28 }
  }
}

Status HTTP são reportados como observados — um 401 é um 401, não "morto".

Por que Lowdown

Agentes frequentemente começam sem histórico compartilhado do comportamento passado de uma ferramenta. Eles não têm como saber quais ferramentas foram confiáveis, quais falham silenciosamente ou quais nunca foram usadas com sucesso para um determinado tipo de tarefa.

O Lowdown resolve isso registrando o que realmente acontece — não avaliações, não resenhas, mas histórico de interações observado. Quando um agente consulta o Lowdown antes de selecionar uma ferramenta, ele está se baseando na experiência coletiva de outros agentes que executaram o mesmo proxy.

O ciclo é simples:

Ler: consulte o histórico observado antes de selecionar uma ferramenta
Usar: execute a ferramenta por meio do proxy
Escrever: o resultado é registrado automaticamente para o próximo agente

Sem avaliações. Sem curadoria humana. Apenas sinal do uso real.

Observações são dados de interação, não julgamentos independentes de qualidade.

Como a rede funciona

Run proxy → node_id auto-created → interactions contributed → deeper Lowdown data

Cada instância do proxy é um nó.

Nós contribuem com dados de interação para a rede compartilhada. Contribuidores obtêm acesso a resultados de consulta mais ricos.

Sem tokens. Sem pontos. Sem resenhas para escrever.

Apenas execute o proxy e compartilhe o que seus agentes experimentam.

Princípios de design

Zero configuração: execute o proxy, todo o resto é automático.
Passagem direta primeiro: o registro nunca bloqueia ou degrada a comunicação MCP.
Apenas fatos: v0 registra sucesso/falha e latência. Julgamentos de qualidade estão fora do escopo.
Proveniência sempre etiquetada: cada registro carrega organic / seeded / synthetic para que dados de inicialização e tráfego real sejam sempre distinguíveis.

Status

Em execução contínua desde setembro de 2026. Desde 6 de outubro de 2026, o Scanner observa as mesmas 2.000 entradas do MCP Registry todos os dias; o relatório diário e os dados brutos são públicos em PetShopBros/lowdown-data. Consulte DESIGN.md para o que está no escopo e o que foi descartado.

Licença

MIT

한국어

한 번도 거래한 적 없는 상대를 에이전트가 무조건 신뢰할 필요는 없습니다.

lowdown-proxy는 AI 에이전트, 도구, 서비스 사이의 상호작용을 기록하고, 그 이력을 누구나 조회할 수 있게 만듭니다. 도구를 선택하거나, API를 호출하거나, 다른 에이전트에게 작업을 위임하기 전에 물어볼 수 있습니다: 네트워크는 이 상대에 대해 무엇을 봤는가?

MCP 서버를 감싸는 stdio 프록시가 첫 번째 진입점입니다. 평판 레이어는 MCP에 국한되지 않고 모든 에이전트, 도구, 서비스에 열려 있습니다.

기록된 데이터는 다른 에이전트가 판단할 때 참고할 수 있는 최소한의 공통 근거가 됩니다.

네트워크 구조

프록시 실행 → node_id 자동 생성 → interaction 기여 → 더 깊은 Lowdown 조회

프록시를 실행하는 것 자체가 노드 참여입니다. 기여할수록 더 상세한 데이터를 조회할 수 있습니다.

Scanner 관찰 데이터

공식 MCP Registry에 등록된 원격 MCP 서버는 응답에 scanner 블록이 함께 옵니다. Lowdown Scanner가 서버에 직접 연결해 관찰한 사실(initialize, tools/list까지만 호출하며 tool은 실행하지 않음)이고, interaction 데이터와 분리되어 success_rate에는 합산되지 않습니다. HTTP 상태는 해석 없이 관찰된 값 그대로 보여줍니다.

앱 로그를 도구 결과에 붙이기

도구 호출은 성공했는데 그 뒤의 앱(씬, 게임, 개발 서버)이 실패하는 경우가 있습니다. 진짜 에러는 앱의 로그 파일에만 찍혀서 에이전트는 모릅니다. --watch-log를 주면 tools/call 결과마다 직전 호출 이후 로그에 새로 찍힌 줄 중 --log-pattern에 맞는 줄이 결과 끝에 붙습니다. 에이전트가 따로 호출할 것은 없습니다. 로그 내용은 로컬에만 머물고 Lowdown에 기록되지 않습니다.

기록 방식 (0.1.17~)

프록시는 공개 API(POST /api/interactions)로 기록합니다. DB 키가 필요 없고 LOWDOWN_SUPABASE_URL / LOWDOWN_SUPABASE_KEY는 더 이상 쓰지 않습니다. LOWDOWN_RECORD=0이면 기록 없이 패스스루만 합니다.

tools/call 결과의 isError: true는 실패(tool_error)로 기록합니다.
잘못된 요청(-32700/-32600/-32601/-32602: 형식 오류, 없는 도구, 잘못된 인자)은 서버 실패와 분리해 rejected_requests로 셉니다. success_rate에는 들어가지 않습니다.
initialize, tools/list 같은 비도구 요청은 protocol_requests로 따로 셉니다.
success_rate는 organic 기록만 계산합니다. seeded / synthetic은 by_source로 따로 보여줍니다. 일부러 실패시키는 테스트는 --test로 실행하면 synthetic으로 남습니다.
각 기록에는 그 시점의 server_version(initialize), schema_hash(tools/list, Scanner와 같은 계산), recorder_version이 함께 남습니다. 인자와 결과 내용은 기록하지 않습니다.
--target을 주지 않으면 명령줄 전체가 아니라 패키지·파일 이름 하나만 라벨로 씁니다.

설계 원칙 (요약)

설정 없음: 프록시를 실행하면 모든 것이 자동으로 처리됩니다.
패스스루 우선: 기록 로직이 실패하거나 느려도 실제 MCP 통신은 절대 막지 않습니다.
사실만 기록: v0는 성공/실패/지연시간만 기록합니다. 품질 판단은 범위 밖입니다.
출처 구분: 모든 기록은 organic / seeded / synthetic으로 태깅됩니다.

자세한 배경과 설계 원칙은 DESIGN.md를 참고하세요.