كيفية استخدام FXMacroData مع Cline AI في VS Code (MCP)

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

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

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

الخطوة 1 افتح لوحة إعدادات Cline MCP

تخزن Cline تكوينات خادم MCP في ملف JSON يمكنك تحريره مباشرة من الإضافة. في VS Code، افتح لوحة Cline الجانبية وانقر على خوادم MCP رمز (شعار القابل) في أعلى اللوحة. ثم انقر على تحرير الإعدادات أو تكوين خوادم MCPلفتح ملف الإعدادات

ملف التكوين موجود في:

# macOS
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# Linux
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# Windows
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

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

داخل ملف التكوين ستجد مستوى أعلى mcpServers ضيف إدخال FXMacroData باستخدام أحد الخيارين أدناه.

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

نقاط كلاين في خادم FXMacroData MCP الإنتاج باستخدام نقل HTTP قابل للنقل. ping أداة العمل على الفور بدون مفتاح API. للعملات غير الدولار الأمريكي إرفق مفتاح إيباي الخاص بك إلى عنوان URL.

{
  "mcpServers": {
    "FXMacroData": {
      "type": "streamableHttp",
      "url": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

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

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

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

الخطوة 3 حفظ وإعادة تحميل Cline

بعد حفظ ملف التكوين، ستقوم Cline باختيار الخادم الجديد تلقائيًا. إذا لم يظهر في قائمة خادم MCP على الفور، قم بإعادة تحميل الإضافة عن طريق النقر على احرص على أيقونة في لوحة خادم MCP، أو إعادة تشغيل VS Code.

بعد تحميل، يجب أن يظهر إدخال خادم FXMacroData مع مؤشر حالة اتصال أخضر في لوحة خادمات Cline MCP.

الخطوة 4 تحقق من الاتصال مع البينغ

افتح دردشة كلاين جديدة واكتب:

Run the FXMacroData ping tool.

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

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

بعد الاتصال، سجل كل الأدوات التي يكتشفها الخادم

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

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

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

احضر أسعار سعر العملة الأمريكية والدولار الأسترالي خلال الـ 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 يتم تشغيله من خلال VS Code ، أو عند إنشاء مزود سياق مخصص يمكنك استفسار 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 إلى Cline AI في خطوتين: أضفت خادم FXMacrData MCP إلى إعدادات Clines JSON وأكدت الاتصال مع ping من هنا، كل سؤال عمومي تكتب في دردشة كلاين يؤدي إلى مكالمة بيانات مباشرة لا توجد تغيير علامة التبويب في المتصفح، لا توفر واردات بيانات يدوية.

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