fxabsolute

fxabsolute-mcp

コーディングエージェントを MCP 経由で FXAbsolute のローソク足履歴に直接接続します。

チャートの画像をモデルに見せるのをやめることが目的です。スクリーンショットではピクセルから価格を読み取る必要がありますが、これらのツールは数値を渡すため、「ニューヨーク市場の寄り付きでは実際に何が起きるのか」という疑問を、推測ではなくクエリで解決できます。

セットアップ

インストールも API キーも不要です。サーバーが必要なデータを取得してキャッシュします。

Claude Code

claude mcp add fxabsolute -- npx -y fxabsolute-mcp

Cursor、Windsurf、Claude Desktop、または設定ファイルを読み込むもの

{
  "mcpServers": {
    "fxabsolute": { "command": "npx", "args": ["-y", "fxabsolute-mcp"] }
  }
}

claude mcp list で確認するか、エージェントに 「fxabsolute にはどの銘柄がありますか？」 と尋ねてください。銘柄が15個あることと、出来高データは利用できないことが返ってくるはずです。

サーバー自体を開発する場合

git clone https://github.com/varsansri/fxabsolute-mcp && cd fxabsolute-mcp
npm install
npm run smoke                # every tool against real data, ~30 checks
node test/proto.mjs          # stdio protocol round-trip
claude mcp add fxabsolute -- node "$PWD/src/index.js"

データの取得元

優先順位は次のとおりです。

1. FXA_DATA_DIR — .bin ファイルが格納された明示的なディレクトリ
2. ../public/data — チェックアウト内で実行する場合に自動的に使用されます
3. FXA_ORIGIN（デフォルトは https://www.fxabsolute.com）— 銘柄ごとに一度だけ取得し、~/.cache/fxabsolute-mcp にキャッシュするため、どのマシンからでも動作します

銘柄ごとに約38 MBです。必要になったときにダウンロードされ、ダウンロードは一度だけです。

ツール

ツール	回答できる内容
fxa_instruments	利用可能な銘柄、バーの数、データに含まれるフィールド
fxa_candles	任意の時間足 M1～W1 における、指定期間の生の OHLC データ
fxa_session_scan	複数月にわたる取引セッションの特定バーと、その要約
fxa_bucket_stats	時間／曜日／月／年ごとにまとめた値動き
fxa_level_touches	価格水準が実際に維持されたかどうかと、その後の反応

ライブチャートブリッジ

ツール	目的
fxa_connect_chart	AI タブに表示されるコードを使って、開いているチャートとペアリングします
fxa_wait_for_message	トレーダーが入力または発話するまで待機し、発言内容とチャートの状態を返します
fxa_reply	チャートパネルに回答します
fxa_set_thinking	長時間の検索中に思考中インジケーターを表示します
fxa_disconnect_chart	セッションを終了します

トレーダーはバックテスターを開き、AI タブに切り替えて、6文字のコードを読み上げます。エージェントは fxa_connect_chart を呼び出し、その後 fxa_wait_for_message → 回答 → fxa_reply のループを実行します。サイトは API キーを保持せず、推論の費用も負担しません。各トレーダーが自分のエージェントを用意します。

各メッセージにはチャートのスナップショットが含まれます。銘柄、時間足、リプレイ位置、現在のローソク足、実際の幾何学的な値で表されたすべての描画（高さのピップ数、またいでいるバーの数、1バーあたりの傾き、フィボナッチ水準、価格がボックス内にあるかどうか）、オープン中の取引、実行中のパフォーマンスです。エージェントは数値を読み取るため、画像から推測する代わりに fxa_session_scan で主張を検証できます。

通信には Supabase Realtime のブロードキャストチャネルを使うため、ブラウザーとエージェントが同じマシン上にある必要はありません。スマートフォン上のチャートを、ノート PC 上のターミナルとペアリングできます。認証情報はサイトの /bridge-config.json から取得します。ここに含まれるのは、すべての訪問者のブラウザーバンドルにすでに含まれている公開可能なキーだけなので、ペアリングに設定は不要です。

リプレイ位置には、トレーダーがまだ到達していないバーを明かさないようエージェントに指示する注記も含まれます。アシスタントが未来を明かしてしまうなら、バックテストに意味はありません。

この機能のきっかけとなったクエリ、つまり「6か月間にわたる、ニューヨーク市場セッションの最初の5分足ローソクを毎日調べる」は、1回の呼び出しで実行できます。

{ "instrument": "SPX500", "session": "nyse", "timeframe": "M5",
  "bars": [1], "from": "2024-01-01", "to": "2024-07-01" }

知っておくべきことが2つあります

出来高はありません。 バイナリ形式は1本のローソク足あたり20バイトです。uint32 のタイムスタンプと、4つの float32 のOHLC値で構成されています。出来高は一度も保存されていないため、どのツールも報告せず、代替値を黙って作り出すこともありません。代わりに rangePips を提供しており、該当するすべてのレスポンスでその旨を明示しています。実際の出来高を追加するには、Dukascopy から約543 MBすべてを、より幅の広いレコード形式で再取得する必要があります。

時間足は配列のインデックスではなく、実際の時刻に基づいて区切られます。 ブラウザーのチャートはN本ごとに集計します。これは1本ずつ再生する場合には適切ですが、分析ではずれが生じます。為替データには週末や祝日の欠損があるため、M1の60本ごとのグループは実際の1時間と一致しなくなり、「H1のローソク足」が週末をまたぐことがあります。ここでは、バーを floor(ts / period) に基づいて区切るため、すべてのバーが実際の境界に揃い、データの欠損箇所には合成バーではなく、バーが存在しません。

セッションの時間帯は、サマータイムを秒単位で考慮した取引所の現地時刻で判定されます。そのため、「09:30のバー」は1月も7月も09:30のバーであり、春になるたびに1時間ずれることはありません。

fxa_session_scan はデータのカバレッジも報告します。指定期間中にデータがまったくなかった平日の日数です。これは思った以上に重要です。2024年前半のSPX500では、平日の約19％でデータが欠損しています。この警告がなければ、指定したデータより5分の1少ないデータに基づく統計が、一見問題なさそうな結果として返されてしまいます。