Pular para o conteúdo

Backtests de Pine no Claude ou via MCP

Hospedado, sem instalação

claude mcp add --transport http pineforge https://mcp.pineforge.dev/mcp

Hospedado: 100 chamadas semanais por IP; cota compartilhada entre backtest_pine e check_tradingview_parity.

Docker local, com os seus próprios dados

docker run --rm -i -v "$PWD:/work" ghcr.io/pineforge-4pass/pineforge-backtest-mcp:latest

Como medimos

Sem Docker, sem instalação. Grátis: 100 chamadas semanais por IP, numa cota compartilhada entre backtest_pine e check_tradingview_parity (as demais ferramentas não consomem cota), com OHLCV de cripto dos últimos 365 dias da Binance, Bybit, OKX e Coinbase. Um orçamento mensal de computação, compartilhado por todos os usuários do plano grátis, pode pausar backtests e verificações de paridade até o início do próximo mês (UTC). O plano com chave de API (histórico completo, limites maiores) está só em lista de espera.

Hospedado: seu código Pine é enviado ao mcp.pineforge.dev para o backtest; o OHLCV vem do nosso dataset. Você não precisa de arquivos locais. Para contar quantos chamadores diferentes usam o servidor hospedado, ele registra o endereço IP de cada chamada de ferramenta (no caso do IPv6, o bloco /64) junto com a semana e o número de chamadas. Esses registros são excluídos depois de 8 semanas; só os totais semanais, sem endereços, são mantidos. Antes desta mudança, só as chamadas que consomem a cota semanal eram registradas por endereço.

O endpoint hospedado é mcp.pineforge.dev/mcp: clientes MCP se conectam a ele via Streamable HTTP, e quem abre o endereço no navegador vê a página de configuração do servidor. Para agentes, há o card do servidor MCP, o llms.txt e o facts.json, que reúne os números de destaque do site em formato de dados, cada grupo com a sua data e a sua fonte.

Setup do cliente

Requer Docker. Monte um diretório de trabalho em /work e use caminhos /work/... para indicar seus CSVs. Sem chave de API: o engine e o transpilador já vêm na imagem.

Local: a transpilação e o backtest rodam dentro do container, então seu código Pine e seu OHLCV ficam na sua máquina, sem chave de API. As únicas chamadas de rede vão para a API pública da Binance: os downloads que você pedir (fetch_binance_ohlcv, binance_symbols), o tamanho do tick de um mercado, quando você informar o símbolo dele, e as barras que o check_tradingview_parity busca quando você não passar nenhuma.

CLI do Claude Code

Hospedado, sem instalação

claude mcp add --transport http pineforge https://mcp.pineforge.dev/mcp

Docker local, com os seus próprios dados

claude mcp add pineforge-local \
  -- docker run --rm -i -v "$PWD:/work" \
  ghcr.io/pineforge-4pass/pineforge-backtest-mcp:latest

Configurações em JSON: Cursor, Claude Desktop e outros

Para clientes que leem um JSON com mcpServers. O Cursor lê esse JSON no .cursor/mcp.json do seu projeto ou, para valer em todos os projetos, no ~/.cursor/mcp.json. O Claude Desktop só lê servidores locais no claude_desktop_config.json (Configurações, Desenvolvedor, Editar configuração); adicione o servidor hospedado como conector personalizado (Personalizar, Conectores, Adicionar conector personalizado). No trecho local, troque /absolute/path/to/your/data pela pasta onde estão seus CSVs.

Hospedado, sem instalação

{
  "mcpServers": {
    "pineforge": {
      "url": "https://mcp.pineforge.dev/mcp"
    }
  }
}

Docker local, com os seus próprios dados

{
  "mcpServers": {
    "pineforge-local": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "/absolute/path/to/your/data:/work",
        "ghcr.io/pineforge-4pass/pineforge-backtest-mcp:latest"
      ]
    }
  }
}

Variáveis de ambiente

PINEFORGE_ALLOW_ANYWHEREpadrão 1
Permite caminhos de OHLCV fora do diretório de trabalho. A imagem do container já deixa isso em 1.
PINEFORGE_DOCKER_TIMEOUT_MSpadrão 120000
Hard kill (ms) pra um run do engine. Default 2 minutos.

11 ferramentas hospedadas, 11 locais

Nos dois servidores

backtest_pine
Transpila, compila e roda nos dados hospedados ou no seu CSV. Devolve o relatório; quando o relatório é grande, o servidor local devolve o resumo direto na resposta.
check_tradingview_parity
Avalia a paridade entre a lista de trades exportada do TradingView e a execução do mesmo script no PineForge.
list_engine_params
Lista todos os overrides de estratégia e todas as configurações de runtime que um backtest aceita. Sem I/O.
engine_info
Reporta o engine: modo, flag baked-in, versão.
list_coverage_topics
Lista todos os tópicos de cobertura do Pine v6, com o status de cada um em uma linha.
get_coverage_topic
Mostra os recursos suportados e não suportados de um tópico de cobertura.
check_pine_feature
Verifica se um identificador específico do Pine é suportado.

Só no servidor hospedado

list_symbols
Lista os símbolos para os quais a API de dados do PineForge fornece OHLCV em um mercado de cripto compatível. Os símbolos vêm da API de dados do PineForge, que cobre quatro exchanges (Binance, Bybit, OKX e Coinbase) com mercados à vista e perpétuos em USDT (Coinbase apenas à vista), filtrados por query (subcadeia sem diferenciar maiúsculas de minúsculas). Grátis.
check_quota
Mostra o saldo da cota semanal por IP, compartilhada entre backtest_pine e check_tradingview_parity (hospedado).
join_waitlist
Coloca você na lista de espera para saber quando o plano com chave de API for lançado: histórico completo de OHLCV e limites maiores.
latest_news
Novidades recentes do PineForge, das mais novas para as mais antigas.

Só no servidor local

binance_symbols
Lista ou filtra os símbolos da Binance pelo servidor local.
backtest_pine_grid
Transpila uma vez, depois compila e roda todas as combinações dos inputs e dos parâmetros sobrescritos de strategy() que você listar, e ranqueia os resultados.
transpile_pine
Transpila Pine v6 para uma unidade de tradução C++, sem executar.
fetch_binance_ohlcv
Baixa candles da Binance, à vista ou USDT-perp, para um CSV pronto para backtest no seu diretório de trabalho, com até 100.000 barras por chamada.

WebMCP: ferramentas para o agente no seu navegador

Em navegadores com suporte a WebMCP, o pineforge.dev oferece estas ferramentas ao seu agente. Elas respondem em inglês, com links para as páginas deste site.

get_evidence
Traz os números de paridade, do placar, do comparativo ou de velocidade, cada um com data, versão e fonte.
search_gallery
Encontra estratégias do corpus aberto por nome, categoria ou nível de paridade.
get_gallery_strategy
Detalha uma estratégia: o nível de paridade, como os trades batem com os do TradingView e os arquivos no corpus.
search_site
Busca nas perguntas frequentes, no blog e nas páginas de metodologia, comparativo e IA.
get_setup
Mostra como configurar o MCP hospedado e o local no seu cliente de IA.
open_page
Abre uma página deste site na sua aba.
read_chart
Devolve o gráfico desta página em números: as tabelas e a fonte.
join_waitlist
Inscreve o seu e-mail para receber os e-mails do PineForge.

As ferramentas do servidor hospedado vêm junto, com os nomes originais, e rodam no próprio servidor.