Cara Menghubungkan FXMacroData ke Windsurf AI (MCP)

Pada akhir panduan ini, Windsurf IDE Anda akan memiliki akses langsung ke seri indikator makroekonomi, kalender rilis, posisi CFTC COT, harga logam mulia, dan kurs spot FX di 18 mata uang semuanya dapat ditanyakan dalam bahasa Inggris sederhana dari dalam editor Anda tanpa meninggalkan aliran pengkodean AI.

Jalan A Hubungkan melalui MCP Direkomendasikan

Model Protokol Konteks (MCP) adalah cara asli untuk menambahkan alat eksternal ke agen Cascade Windsurf. Satu blok konfigurasi JSON dan Cascade secara otomatis menemukan setiap alat yang diekspos server FXMacroData tidak ada definisi skema, tidak ada boilerplate HTTP.

Langkah 1 Buka file konfigurasi MCP

Windsurf menyimpan definisi server MCP dalam file JSON di:

~/.codeium/windsurf/mcp_config.json

Anda dapat membuka file ini langsung di Windsurf melalui palet perintah (Ctrl+Shift+P / Cmd+Shift+P) dan mencari Windsurf: Buka MCP Config, atau dengan menavigasi ke Pengaturan Windsurf → MCP dan mengklik. Edit configJika file belum ada, buatlah.

Langkah 2 Tambahkan entri server FXMacroData

Tambahkan entri untuk FXMacroData di dalam mcpServers Pilih opsi yang paling sesuai dengan pengaturan Anda:

Opsi A Endpoint host (tidak ada instalasi, paling sederhana)

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

Ini menunjukkan Cascade pada server MCP produksi FXMacroData menggunakan transportasi HTTP Streamable. ping alat bekerja segera tanpa kunci API. Untuk mata uang non-USD, lampiran kunci API Anda ke URL:

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

Pilihan B Server MCP lokal melalui uvx

Gunakan ini jika Anda lebih memilih proses lokal atau jika jaringan Anda membatasi streaming HTTP keluar. uvx Runner mengunduh dan menjalankan mcp-server-fxmacrodata Paket PyPI secara otomatis.

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

Langkah 3 Mengisi ulang server MCP Windsurf

Setelah menyimpan file konfigurasi, muat ulang server MCP sehingga Windsurf mengambil entri baru.Ctrl+Shift+P / Cmd+Shift+P) dan lari:

Windsurf: Refresh MCP Servers

Atau, navigasi ke Pengaturan Windsurf → MCP dan klik ikon refresh di sebelah daftar server Anda. Anda harus melihat fxmacrodata muncul dalam daftar server aktif dengan indikator terhubung hijau.

Langkah 4 Memverifikasi koneksi di Cascade

Buka panel Cascade dan pastikan kau masuk. Agen mode (bukan Edit atau Chat).

Run the FXMacroData ping tool.

Cascade memanggil ping alat di latar belakang. pong respon mengkonfirmasi server dapat dihubungi dan kredensial Anda valid. Anda siap untuk menanyakan data langsung.

Langkah 5 Jelajahi alat yang tersedia

Setelah terhubung, Cascade mendaftar semua alat yang diekspos server.

Cascade memutuskan alat mana yang akan dipanggil dari prompt bahasa alami Anda. Anda tidak perlu menentukan nama alat atau membangun JSON hanya mengajukan pertanyaan.

Langkah 6 Cobalah alur kerja analis yang sebenarnya

Anda sedang membangun sinyal carry-trade di notebook Python dan ingin membandingkan perbedaan kebijakan-tingkat USDAUD dengan pergerakan spot AUD/USD selama setahun terakhir.

Membawa nilai kebijakan USD dan AUD selama 12 bulan terakhir, kemudian menarik nilai spot AUD/USD untuk jendela yang sama dan menulis kode Python untuk memetakan perbedaan nilai di samping nilai tukar.

Telepon bergelombang. indicator_query dua kali (satu kali per mata uang) dan forex Setelah itu, tulis kode plot langsung ke file terbuka Anda.

# 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"

Perwakilan indicator_query Jawaban:

{
  "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 }
  ]
}

Dengan kebijakan-tingkat dan seri forex di tangan, Cascade dapat perancah grafik perbandingan penuh tanpa Anda menulis panggilan HTTP tunggal. Halaman indikator suku bunga kebijakan AUD Dan Dokumen suku bunga kebijakan USD menunjukkan skema indikator lengkap jika Anda ingin memperluas analisis.

Jalan B panggilan API REST langsung Alternatif

Jika Anda lebih suka panggilan HTTP eksplisit misalnya di dalam buku catatan Jupyter yang terbuka di Windsurf, atau saat membangun penyedia konteks Cascade khusus Anda dapat menanyakan FXMacroData langsung melalui REST. Semua endpoint menerima kunci API parameter kueri.

Mengambil data indikator

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"])

Memeriksa kalender rilis

# 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"])

Pembuangan nilai spot FX

# 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}

Daftar lengkap mata uang dan indikator yang tersedia dapat dilihat di /api-data-docsSetiap halaman indikator mencakup jalur titik akhir yang tepat, deskripsi lapangan, dan contoh tanggapan misalnya Inflasi EUR atau USD non-perhutanan gaji.

Ringkasan

Anda telah mengkabel FXMacroData ke Windsurf dalam dua langkah: menambahkan entri ke ~/.codeium/windsurf/mcp_config.json menunjuk ke server FXMacroData MCP, dan mengkonfirmasi koneksi dengan ping panggilan dalam mode Cascade Agent. Dari sini, setiap pertanyaan makro yang Anda ketik di Cascade memicu panggilan data langsung tidak ada tab browser-switching, tidak ada impor data manual.

Siap untuk menjelajahi data apa yang tersedia? FXMacroData API dokumen Untuk katalog indikator lengkap, atau periksa Referensi server MCP Jika Anda belum memiliki kunci API, Langganan untuk membuka semua 18 mata uang dan set indikator lengkap.