
Quick Start
# Install
go install github.com/bullarc/bullarc/cmd/bullarc@latest
# Run the built-in demo (zero config, embedded data)
bullarc demo
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者

# Install
go install github.com/bullarc/bullarc/cmd/bullarc@latest
# Run the built-in demo (zero config, embedded data)
bullarc demo
AI-powered technical analysis engine — 11 indicators, multi-source signal fusion, backtesting, paper trading, and MCP server for Claude. Written in Go.
No API keys, no config files, no data downloads. Results in under a second.
Analyze — 6 data layers, 11 indicators, 1 composite signal
bullarc analyze --symbol AAPL --llm
Backtest — replay strategies on historical data
bullarc backtest --csv data.csv --indicators RSI_14,MACD_12_26_9,SuperTrend_7_3.0
Paper trade — auto-execute with real market data, simulated money
bullarc paper trade --symbol AAPL --confidence 70
AI review — Claude analyzes your trading patterns after 20+ trades
bullarc journal review
MCP server — let Claude be your analyst in Claude Desktop or Cursor
MASSIVE_API_KEY=xxx bullarc mcp install # one-command Claude Code setup
# Store credentials once (optional — works without any keys via CSV mode)
bullarc configure --massive-key $MASSIVE_API_KEY
bullarc configure --alpaca-key $ALPACA_API_KEY --alpaca-secret $ALPACA_SECRET_KEY
bullarc configure --llm-key $ANTHROPIC_API_KEY
# Or just set env vars — bullarc auto-detects them
export MASSIVE_API_KEY=xxx # Massive market data
export ALPACA_API_KEY=xxx # Alpaca market data (alternative)
export ALPACA_SECRET_KEY=xxx
export ANTHROPIC_API_KEY=xxx # LLM explanations (optional)
Or use a config file:
data_sources:
default: massive
massive:
enabled: true
api_key: "${MASSIVE_API_KEY}"
llm:
provider: anthropic
api_key: "${ANTHROPIC_API_KEY}"
model: claude-opus-4-6
Credential resolution order: flags > env vars > keystore (~/.config/bullarc/credentials) > config file.
# One-command setup for Claude Code (auto-detects env vars)
MASSIVE_API_KEY=xxx bullarc mcp install
# Or start manually
bullarc mcp
The install command registers bullarc globally in Claude Code — no config files
needed. It detects MASSIVE_API_KEY, ALPACA_API_KEY, ALPACA_SECRET_KEY, and
ANTHROPIC_API_KEY from your environment and forwards them to the MCP server.
Exposes 10 tools over JSON-RPC 2.0 stdio:
bullarc.go # All interfaces and types. The API contract.
cmd/bullarc/ # CLI (cobra). Thin wrapper over the SDK.
internal/engine/ # Wires indicators, data sources, LLMs together.
internal/indicator/ # Pure computation. No I/O, no imports from other internals.
internal/datasource/ # Market data fetching. Implements DataSource interface.
internal/llm/ # LLM adapters. Implements LLMProvider interface.
internal/signal/ # Aggregates indicator outputs into Signal values.
internal/config/ # Config loading and credential storage.
internal/mcp/ # MCP server: JSON-RPC 2.0 over stdio.
internal/journal/ # Trade journal logging and querying.
pkg/sdk/ # Public Go SDK. Wraps the engine behind a stable surface.
testutil/ # Shared test helpers.
testdata/ # CSV fixtures and reference values.
All shared types and interfaces live in the root package. Internal packages
implement those interfaces but never import each other. Only internal/engine
wires them together.
client := sdk.New(engine)
// One-shot analysis
result, err := client.Analyze(ctx, bullarc.AnalysisRequest{Symbol: "AAPL", UseLLM: true})
// Backtest
result, err := client.Backtest(ctx, bullarc.BacktestRequest{Symbol: "AAPL", Bars: bars})
// Stream signals (polling)
ch := client.StreamSymbols(ctx, []string{"AAPL", "MSFT"}, 5*time.Minute)
for sig := range ch {
// sig.Type, sig.Confidence, sig.Symbol
}
// Push-based subscription
ch := client.Subscribe(ctx, bullarc.AnalysisRequest{Symbol: "AAPL"})
make build # Produces bin/bullarc
make test # All tests with race detector
make check # fmt + vet + test
make verify # Build all + smoke tests
make lint # golangci-lint
make demo # Run the built-in demo
make demo-gif # Generate demo.gif (requires VHS)
docker run --rm \
-e MASSIVE_API_KEY=<key> \
-e ANTHROPIC_API_KEY=<key> \
ghcr.io/bullarc/bullarc:latest analyze --symbol AAPL --llm
MIT — see LICENSE for details.
AI-powered technical analysis engine — 11 indicators, multi-source signal fusion, backtesting, paper trading, and MCP server for Claude. Written in Go.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Bullarc 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 AI-powered technical analysis engine — 11 indicators, multi-source signal fusion, backtesting, paper trading, and MCP server for Claude. Written in Go.