Pra assistentes de IA · servidor MCP

Faça backtest de estratégias Pine a partir do Claude, Cursor ou qualquer cliente MCP.

@pineforge/codegen-mcp é um servidor MCP local em stdio que deixa seu agente de IA transpilar Pine pra C++ e rodar backtests Docker nos seus dados. Um pacote npm, zero código de cola.

Instalar

npx -y @pineforge/codegen-mcp

Precisa de Node ≥ 20 · daemon Docker · uma API key do PineForge (pf_…)

Privacidade

Arquivos OHLCV nunca saem da sua máquina. Só o source Pine viaja pra API de codegen. Backtests rodam em Docker no seu daemon local.

Setup do cliente

Funciona com qualquer cliente que entenda MCP.

Claude Desktop

Adicione no seu claude_desktop_config.json (Settings → Developer → Edit Config). Substitua pf_... pela sua key.

claude_desktop_config.json

{
  "mcpServers": {
    "pineforge-codegen": {
      "command": "npx",
      "args": ["-y", "@pineforge/codegen-mcp"],
      "env": {
        "PINEFORGE_API_KEY": "pf_..."
      }
    }
  }
}

Claude Code CLI

Registre o servidor de uma vez na CLI do claude:

bash

claude mcp add pineforge-codegen \
  --transport stdio \
  --env PINEFORGE_API_KEY=pf_... \
  -- npx -y @pineforge/codegen-mcp

Cursor

Settings → MCP → New MCP Server → cole o JSON do Claude Desktop acima.

Ferramentas expostas

Sete ferramentas, três superfícies.

nome	roda em	quota	o que faz
transpile_pine	remote API	counts	Source Pine v6 → translation unit C++ pronto pro runtime
backtest_pine	local Docker	counts 1	Ponta a ponta: transpile + compile + run contra seu CSV. Devolve o relatório completo.
backtest_pine_grid	local Docker	counts 1	Sweep cartesiano sobre inputs/overrides — um transpile, vários runs no docker. Devolve sumários ranqueados.
get_quota	remote API	free	Checa o tier da sua API key e o orçamento de transpile restante
fetch_binance_ohlcv	Binance public API	free	Puxa OHLCV de spot ou USDT-perp da API pública da Binance num CSV pronto pra backtest. Grátis.
binance_symbols	Binance public API	free	Descobre/valida símbolos da Binance (com cache). Filtra por quote, status, tipo de contrato.
pull_engine_image	local Docker	free	Pega a última imagem Docker do pineforge-engine no GHCR

Variáveis de ambiente

variável	default	função
PINEFORGE_API_KEY	(required)	Bearer token pra API de codegen. Pegue uma na waitlist abaixo.
PINEFORGE_GATEWAY	production URL	Sobrescreve o host da API. Default é o codegen-gateway de produção.
PINEFORGE_ALLOW_ANYWHERE	0	Coloque 1 pra permitir caminhos OHLCV fora do cwd do MCP.
PINEFORGE_DOCKER_TIMEOUT_MS	120000	Hard kill (ms) pra docker pull / docker run. Default 2 minutos.

Começar

Pega uma key gratuita e começa a prompar.

Deixe seu e-mail na waitlist da home. Mandamos sua API key de codegen por e-mail em segundos. Pluga no config MCP acima e começa a fazer backtest a partir do seu assistente de IA.

Pegar uma key gratuita Ver no npm

Quer construir uma estratégia na mão? Comece pelo runtime aberto →