ClaudeやMCPでPineをバックテスト

ホスト型（インストール不要）

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

ホスト型：backtest_pineとcheck_tradingview_parityで、IPごとに週100回の枠を共有。

ローカルDocker（お手元のデータで）

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

計測方法

Docker不要、インストール不要。無料でAPIキーも不要です。backtest_pineとcheck_tradingview_parityは、IPごとに週100回の枠を共有し、ほかのツールはこの枠を消費しません。Binance、Bybit、OKX、Coinbaseの直近365日分の暗号資産OHLCVを使えます。無料ユーザー全員で共有する月間の計算リソース枠が上限に達すると、UTCで翌月になるまでバックテストとパリティチェックが一時停止します。APIキーティア（全履歴、より高い上限）は、ウェイトリスト登録者のみが対象です。

ホスト型：Pineソースはバックテストのためmcp.pineforge.devへ送信されます。OHLCVは当方のデータセットから配信されるため、ローカルファイルは不要です。ホスト型サーバーを利用する呼び出し元がいくつあるかを数えるため、すべてのツール呼び出しのIPアドレス（IPv6の場合は/64ブロック）を、週と回数とあわせて記録します。これらの記録は8週間後に削除され、アドレスを含まない週ごとの合計のみが保持されます。この変更までは、週の枠を消費する呼び出しのみがIPアドレスで記録されていました。

ホスト型のエンドポイントはmcp.pineforge.dev/mcpです。MCPクライアントはStreamable HTTPで接続でき、ブラウザで開くとサーバーの設定手順を案内するページが表示されます。エージェント向けには、MCPサーバーカードとllms.txtに加え、サイトに掲載している主要な数値を、グループごとに日付と出典を添えてデータとしてまとめたfacts.jsonがあります。

クライアント設定

Dockerが必要です。作業ディレクトリを/workにマウントし、CSVは/work/...のパスで指定してください。APIキーは不要です。エンジンとトランスパイラはイメージに同梱されています。

ローカル：トランスパイルもバックテストもコンテナ内で実行されるため、PineのソースコードもOHLCVも手元のマシンから出ず、APIキーも不要です。ネットワーク通信が発生するのは、BinanceのパブリックAPIへのアクセスだけです。内訳は、リクエストしたダウンロード（fetch_binance_ohlcv、binance_symbols）、シンボルを指定したときの市場のティックサイズ、そしてバーを渡さなかったときにcheck_tradingview_parityが取得するバーです。

Claude Code CLI

ホスト型（インストール不要）

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

ローカルDocker（お手元のデータで）

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

JSON設定：Cursor、Claude Desktopなど

mcpServersのJSONを読み込むクライアント向けです。Cursorは、プロジェクト内の.cursor/mcp.jsonか、全プロジェクト共通の~/.cursor/mcp.jsonから読み込みます。Claude Desktopがclaude_desktop_config.json（Settings、Developer、Edit Config）から読み込むのはローカルサーバーだけです。ホスト型サーバーは、代わりにカスタムコネクタとして追加してください（Customize、Connectors、Add custom connector）。ローカル用のスニペットでは、/absolute/path/to/your/dataを、CSVを置いたフォルダのパスに置き換えてください。

ホスト型（インストール不要）

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

ローカルDocker（お手元のデータで）

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

環境変数

PINEFORGE_ALLOW_ANYWHEREデフォルト 1: 作業ディレクトリ外のOHLCVパスを許可。コンテナイメージではこれが1に設定されています。
PINEFORGE_DOCKER_TIMEOUT_MSデフォルト 120000: エンジン実行のハードキル（ms）。デフォルトは2分。

ツールはホスト型で11個、ローカルで11個

両方のサーバー

backtest_pine: トランスパイルとコンパイルを行い、ホスト型のデータまたはお手元のCSVで実行します。レポートを返します。レポートが大きい場合、ローカルサーバーはサマリーをインラインで返します。
check_tradingview_parity: TradingViewから出力した取引一覧を、同じスクリプトをPineForgeで実行した結果と照合し、評価します。
list_engine_params: バックテストで指定できる戦略の上書き設定とランタイム設定を、すべて一覧表示します。I/Oは発生しません。
engine_info: エンジン情報を報告：モード、ビルトインフラグ、バージョン。
list_coverage_topics: Pine v6のカバレッジトピックをすべて、1行のステータス付きで一覧表示します。
get_coverage_topic: 1つのカバレッジトピックについて、対応済みと未対応の機能を表示します。
check_pine_feature: 特定のPine識別子に対応しているかを確認します。

ホスト型のみ

list_symbols: PineForgeのデータAPIが対応する1つの暗号資産市場でOHLCVを提供するシンボルを一覧表示します。シンボルはPineForgeのデータAPIから取得され、4つの取引所（Binance、Bybit、OKX、Coinbase）の現物とUSDT無期限市場をカバーします（Coinbaseは現物のみ）。query（大文字と小文字を区別しない部分文字列）で絞り込みます。無料です。
check_quota: backtest_pineとcheck_tradingview_parityで共有する今週の残り回数を確認します（ホスト型のみ）。
join_waitlist: ウェイトリストに登録し、APIキーティア（OHLCVの全履歴と、より高い上限）の提供開始時にお知らせを受け取ります。
latest_news: PineForgeの最近のプロダクトニュースを、新しい順に返します。

ローカルのみ

binance_symbols: ローカルサーバーでBinanceのシンボルを一覧表示・絞り込みします。
backtest_pine_grid: トランスパイルは1回だけ行い、指定した入力パラメータとstrategy()の上書き設定の組み合わせをすべてコンパイルして実行し、結果をランク付けします。
transpile_pine: Pine v6を実行せずに、C++の翻訳単位へトランスパイルします。
fetch_binance_ohlcv: Binanceの現物またはUSDT建て無期限先物のローソク足を、バックテストにそのまま使えるCSVとして作業ディレクトリにダウンロードします。1回の取得で最大100,000バーです。

WebMCP：ブラウザ上のエージェント向けツール

WebMCPに対応したブラウザでは、お使いのエージェントがpineforge.devの次のツールを使えます。ツールの応答は英語で、このサイトのページへのリンクが付きます。

get_evidence: パリティチェック、スコアボード、エンジン比較、速度ベンチマークの数値を、測定日・対象リリース・出典とあわせて返します。
search_gallery: 公開コーパスの戦略を、名前やカテゴリー、評価ランクで検索します。
get_gallery_strategy: 指定した戦略の評価ランク、TradingViewとの取引の一致状況、コーパスのファイルを返します。
search_site: FAQ、ブログ、「検証方法」「エンジン比較」「AI連携」の各ページを検索します。
get_setup: ホスト型とローカルのMCPサーバーの設定手順を、お使いのAIクライアントに合わせて返します。
open_page: このサイトのページを、現在のタブで開きます。
read_chart: このページのグラフを数値で読み取り、データ表と出典を返します。
join_waitlist: メールアドレスを、PineForgeからのお知らせメールに登録します。

このほか、ホスト型サーバーのツールも元の名前のまま使えます。実行はサーバー側で行われます。