كيفية توصيل FXMacroData إلى Windsurf AI (MCP)

بحلول نهاية هذا الدليل سيكون لديك إدارة المعلومات الالكترونية لـ Windsurf إمكانية الوصول مباشرة إلى سلسلة المؤشرات الاقتصادية الكلية، وتقويمات الإصدارات، وموقع CFTC COT، وأسعار المعادن الثمينة، وأعداد الفورية للعملات الأجنبية عبر 18 عملة كل ذلك قابل للسؤال باللغة الإنجليزية البسيطة من داخل محررك دون مغادرة تدفق برمجة الذكاء الاصطناعي.

الطريق أ الاتصال عبر MCP أوصى

بروتوكول السياق النموذجي (MCP) هي الطريقة الأصلية لإضافة أدوات خارجية إلى وكيل كاسكاد في ويندسرف. كتلة تكوين JSON واحدة و كاسكد يكتشف تلقائيًا كل أداة يعرضها خادم FXMacroData لا تعريفات مخطط ، لا حاوية HTTP.

الخطوة 1 افتح ملف تكوين MCP

تقوم ويندسرف بتخزين تعريفات خادم MCP في ملف JSON على:

~/.codeium/windsurf/mcp_config.json

يمكنك فتح هذا الملف مباشرة في ويندسرف عن طريق لوحة الأوامر (Ctrl + Shift + P - لا ، لا Cmd+Shift+Pو أبحث عن ويندسرف: افتح تكوين MCPأو من خلال التنقل إلى إعدادات الرياح و النقر تحرير التكوينإذا لم يكن الملف موجوداً بعد، قم بإنشائه.

الخطوة 2 إضافة إدخال خادم FXMacroData

إضافة إدخال لـ FXMacroData داخل mcpServers اختر الخيار الذي يناسب إعدادك

الخيار A نقطة نهاية مستضافة (صفر تثبيت، أبسط)

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

هذا يشير كاسكاد إلى خادم FXMacroData MCP الإنتاج باستخدام نقل HTTP قابل للنقل. ping أداة العمل على الفور دون مفتاح API. للعملات غير الدولار الأمريكي، إضافة مفتاحها إلى عنوان URL:

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

الخيار ب خادم MCP المحلي عبر uvx

استخدم هذا إذا كنت تفضل عملية محلية أو إذا كانت شبكتك تحد من البث HTTP الخارجي. uvx يُحمّل ويقوم بـ تنفيذ mcp-server-fxmacrodata حزمة PyPI تلقائياً

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

الخطوة 3 إعادة تحميل خوادم MCP Windsurf

بعد حفظ ملف التكوين، إعادة تحميل خوادم MCP حتى يلتقط ويندسرف الإدخال الجديد. افتح لوحة الأوامر (Ctrl + Shift + P - لا ، لا Cmd+Shift+Pو أركض

Windsurf: Refresh MCP Servers

أو، انقر إلى إعدادات الرياح ثم انقر على رمز التجديد بجانب قائمة الخادم fxmacrodata تظهر في قائمة الخادم النشط مع مؤشر متصل أخضر.

الخطوة 4 تحقق من الاتصال في Cascade

افتح لوحة " كاسكاد " وتأكد من أنك موجود عميل وضع (ليس تحرير أو دردشة).

Run the FXMacroData ping tool.

كاسكاد) يطلب) ping أداة في الخلفية pong الإجابة تؤكد أن الخادم قابل للإتصال وبيانات الاعتماد الخاصة بك صالحة. أنت مستعد لاستفسار البيانات الحية.

الخطوة 5 استكشاف الأدوات المتاحة

بعد الاتصال، تسجل كاسكيد جميع الأدوات التي يعرضها الخادم.

تقوم Cascade بحل أي أداة تستدعي من إشارة اللغة الطبيعية. لا تحتاج أبداً إلى تحديد اسم الأداة أو بناء JSON فقط اطلب السؤال.

الخطوة 6 جرب سير العمل المحلل الحقيقي

أنت تقوم ببناء إشارة التجارة في دفتر ملاحظات بايثون وتريد مقارنة فارق سعر السياسة USDAUD مع حركة الفورية AUD/USD خلال العام الماضي. في وضع وكيل Cascade، استفسار Windsurf:

احضر أسعار سعر العملة الأمريكية والدولار الأسترالي خلال الـ 12 شهراً الماضية، ثم سحب سعر الفورية للدولار الأوروبي مقابل الدولار الأمريكي لنفس النافذة واكتب رمز بايثون لرسم الفارق السعر جنباً إلى جنب مع سعر الصرف.

مكالمات مستمرة indicator_query مرتين (مرة واحدة لكل عملة) و 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 واحدة. صفحة مؤشر سعر الفائدة السياسية للدولار الأسترالي و أسعار سعر العملة الأمريكية يظهر مخطط المؤشر الكامل إذا كنت ترغب في توسيع التحليل.

الطريق ب مكالمات API REST المباشرة البديل

إذا كنت تفضل مكالمات HTTP صريحة على سبيل المثال داخل دفتر ملاحظات Jupyter مفتوح في Windsurf ، أو عند إنشاء مزود سياق Cascade مخصص يمكنك استفسار FXMacroData مباشرة عبر REST. جميع النقاط النهائية تقبل مفتاح 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 /أبي بياناتكل صفحة مؤشر تتضمن مسار نقطة النهاية الدقيقة، وصف الحقول، وأمثلة الاستجابات على سبيل المثال التضخم في اليورو أو الرواتب غير الزراعية بالدولار.

ملخص

لقد قمت بتوصيل FXMacroData إلى ويندسرف في خطوتين: أضف إدخال إلى ~/.codeium/windsurf/mcp_config.json و قد أكدت الاتصال مع ping من هنا، كل سؤال ماكرو تكتب في كاسكيد يؤدي إلى مكالمة بيانات مباشرة لا توجد تغيير علامة تبويب المتصفح، لا توفر واردات بيانات يدوية.

هل أنت مستعد لاستكشاف البيانات المتاحة؟ مستندات FXMacroData API لمجموعة كاملة من المؤشرات، أو تحقق من مرجع خادم MCP لخيارات المصادقة ومخططات الأدوات المتقدمة. إذا لم يكن لديك مفتاح API بعد، اشترك لفتح جميع العملات الـ 18 ومجموعة المؤشرات الكاملة