FXMacroData を Windsurf AI (MCP) に接続する方法

このガイドの終わりまでに,Windsurf IDEは,マクロ経済指標シリーズ,リリースカレンダー,CFTC COTのポジション,貴金属価格,および18の通貨のFXスポットレートへのライブアクセスができます. すべてはAIコーディングフローを離れずに編集者内部からシンプルな英語で検索できます.

経路A MCP 経由で接続 推奨

モデルコンテキストプロトコル (MCP) is the native way to add external tools to Windsurf’s Cascade agent. One JSON config block and Cascade auto-discovers every tool the FXMacroData server exposes — no schema definitions, no HTTP boilerplate.

ステップ 1 MCP 設定ファイルを開く

Windsurf は JSON ファイルで MCP サーバの定義を保存します.

~/.codeium/windsurf/mcp_config.json

このファイルは Windsurf で直接コマンドパレットで開くことができます (Ctrl+Shift+P / Cmd+Shift+P について探している ウィンドサーフ: MCP Config を開く移動する ウェンドサーフ設定 → MCP 音が鳴って 設定を編集するファイルがまだ存在しない場合は,それを作成します.

ステップ2 FXMacroData サーバーのエントリを追加

内部にFXMacroDataのエントリを追加する mcpServers 設定に最も適したオプションを選択します:

選択肢A ホストされたエンドポイント (ゼロインストール,最もシンプル)

{
  "mcpServers": {
    "fxmacrodata": {
      "serverUrl": "https://fxmacrodata.com/mcp"
    }
  }
}

流通可能なHTTP輸送を使用する生産FXMacroData MCPサーバーにキャスケードを指します. ping 通貨の場合は,URLにAPIキーを添付してください.

{
  "mcpServers": {
    "fxmacrodata": {
      "serverUrl": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

選択肢B ローカルMCPサーバー uvx

ネットワークが出力HTTPストリーミングを制限している場合,これを使用します. uvx 実行します. mcp-server-fxmacrodata について 自動で PyPI パッケージ

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Step 3 — Reload Windsurf MCP servers

MCPサーバを再読み込み,新しいエントリをWindsurfで拾う.コマンドパレットを開く (Ctrl+Shift+P / Cmd+Shift+P について走って

Windsurf: Refresh MCP Servers

選択してください ウェンドサーフ設定 → MCP サーバーリストの隣のリフレッシュアイコンをクリックします. fxmacrodata は,このデータについて 緑色の接続指示でアクティブサーバーリストに表示されます.

ステップ 4 Cascade で接続を確認

カスケードパネルを開いて 確認してください 代理人 編集やチャットではなく,タイプ:

Run the FXMacroData ping tool.

カスケードが呼んでいる ping 背景にあるツールです pong サーバーがアクセス可能で,あなたの認証は有効です.あなたはライブデータへのクエリを準備しています.

ステップ5 入手可能なツールを探求

接続されたら Cascade はサーバーが暴露するすべてのツールを登録します.

ツール名やJSONの構築を指定する必要はありません. 単に質問をするだけです. ツール名は,JSONに変更されます.

ステップ6 リアルな分析作業を試す

You are building a carry-trade signal in a Python notebook and want to compare the USD–AUD policy-rate differential with AUD/USD spot movement over the last year. In Cascade Agent mode, prompt Windsurf:

過去12ヶ月間のUSDとAUDの政策レートを取得し,同じウィンドウのAUD/USDの即時レートを引き出し,レートの差を為替レートとグラフ化するためにPythonコードを書きます.

波の電話 indicator_query twice (once per currency) and forex ツール呼び出しは,次のようになります. ツールを呼び出す時に,RESTの呼び出しが実行されます.

# USD policy rate
curl "https://fxmacrodata.com/api/v1/announcements/usd/policy_rate?api_key=YOUR_API_KEY"

# AUD policy rate
curl "https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY"

# AUD/USD spot rate
curl "https://fxmacrodata.com/api/v1/forex/AUD/USD?api_key=YOUR_API_KEY"

代表者 indicator_query 答え:

{
  "currency": "AUD",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-04-01", "val": 4.10, "announcement_datetime": 1743483000 },
    { "date": "2026-02-18", "val": 4.10, "announcement_datetime": 1739862600 },
    { "date": "2025-12-10", "val": 4.35, "announcement_datetime": 1733806200 },
    { "date": "2025-11-05", "val": 4.35, "announcement_datetime": 1730793000 }
  ]
}

単一のHTTPコールを書く必要もなく,完全な比較チャートを構築できます. 計算機は,すべてのデータと AUD政策金利指標ページ ほら 政策金利の文書 分析を拡張したい場合は,インディケーターのスケーマを表示します.

経路B 直接REST API 呼び出し 代替

Windsurf で開いた Jupyter ノートブック内,またはカスタム Cascade コンテキスト プロバイダーを作成するときに,REST を介して直接 FXMacroData に問い合わせることができます.すべてのエンドポイントは,クエリパラメータ API キーを受け入れる.

指標データを取得する

import requests

BASE = "https://fxmacrodata.com/api/v1"
KEY  = "YOUR_API_KEY"

# Latest AUD inflation series
resp = requests.get(
    f"{BASE}/announcements/aud/inflation",
    params={"api_key": KEY},
    timeout=10,
)
data = resp.json()
for row in data["data"][:5]:
    print(row["date"], row["val"])

リリースカレンダーを確認

# Upcoming USD releases
resp = requests.get(
    f"{BASE}/calendar/usd",
    params={"api_key": KEY},
    timeout=10,
)
events = resp.json()
for event in events["data"][:3]:
    print(event["indicator"], event["release_date"])

外国為替の即時レートの引き上げ

# EUR/USD last 30 trading days
resp = requests.get(
    f"{BASE}/forex/EUR/USD",
    params={"api_key": KEY},
    timeout=10,
)
rates = resp.json()["data"]
print(rates[0])  # {"date": "2026-04-15", "rate": 1.1342}

通貨と指標の完全なリストは /api-data-docs ファイルファイル特定のエンドポイントの経路,フィールド説明,および例の応答を含む. ユーロインフレ ほら 農地以外の賃金の表ほら

概要

追加した ファイル ~/.codeium/windsurf/mcp_config.json 接続を確認しました. 接続は, ping ここから,あなたがカスケードに入力するすべてのマクロ質問は,ライブデータコールを起動します. ブラウザのタブ切り替え,手動データインポートなどありません.

入手可能なデータを探索する準備はできましたか? FXMacroData API ドキュメント 詳細は,このページから確認できます. MCP サーバー参照 認証オプションや高度なツールスキーマの利用も可能です. サブスクリプト すべての18通貨と完全な指標セットをロックします.