كيفية توصيل FXMacroData إلى AI المؤشر (MCP)

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

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

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

الخطوة 1 افتح إعدادات MCP في المؤشر

يقرأ المؤشر تعريفات خادم MCP من ملف JSON. هناك مجالين يمكنك استخدامهما:

• العالمية (توصى بها) متاح في جميع مشاريعك. إعدادات المؤشر (Cmd+Shift+J على ماكوس أو Ctrl + Shift + J على ويندوز/لينكس) ، انتقل إلى MCP، ونقر على إضافة خادم MCP عالمي جديدهذا يفتح ~/.cursor/mcp.json.
• مستوى المشروع مُحددة لمجال عمل واحد. .cursor/mcp.json في الملف في الجذر من دليل المشروع الخاص بك.

في كلتا الحالتين، فإن بنية JSON هي نفسها. اختر الخيار الذي يناسب سير العمل الخاص بك.

الخطوة 2 إضافة تكوين خادم FXMacroData MCP

افتح ~/.cursor/mcp.json (عالميا) أو .cursor/mcp.json (مشروع) وإضافة إدخال FXMacroData. هناك خياران متاحان اعتمادا على ما إذا كنت تفضل نقطة نهاية مضيفة أو عملية محلية.

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

يشير المؤشر مباشرة إلى خادم FXMacroData MCP الإنتاج عبر HTTP قابل للنقل. ping أداة العمل على الفور دون مفتاح API.

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

للحصول على الوصول الكامل إلى عملات متعددة، قم بإرفاق مفتاح API الخاص بك إلى عنوان URL:

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

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

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

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

الخطوة 3 إعادة تشغيل المؤشر وتحقق من الخادم يظهر

بعد حفظ ملف JSON، إعادة تشغيل المؤشر (أو إعادة تحميل النافذة مع Cmd+Shift+P - لا ، لا Ctrl + Shift + P ! المطور: إعادة تحميل النافذة) ، سيقوم المؤشر بتحليل تكوين MCP وتسجيل أي خوادم يجدها.

لتأكيد أن الخادم محمل، افتح إعدادات المؤشر → MCPيجب أن ترى fxmacrodata تمت إدراجها مع مؤشر حالة أخضر. إذا كان الوضع يظهر خطأ، تحقق من تركيبة JSON وتأكد من uvx يتم تثبيتها (للاختيار ب).

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

افتح لوحة الدردشة للمؤشر، واصنع عميل الوضع والنوع:

Run the FXMacroData ping tool.

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

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

بمجرد الاتصال، وكيل العارض لديه الوصول إلى جميع الأدوات التي يكتشفها خادم FXMacroData:

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

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

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

احضر أسعار سعر العملة الأمريكية والدولار الأسترالي خلال الـ 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 يتم تشغيله من خلال Cursor ، أو عند إنشاء أداة سياق مخصصة يمكنك استفسار 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 إلى العدسة في خطوتين: أضفت تكوين الخادم إلى ~/.cursor/mcp.json (أو ما يعادلها على مستوى المشروع) وأكد على الارتباط مع ping من هنا، كل سؤال ماكرو تكتب في لوحة عامل العرض يطلق دعوة بيانات مباشرة لا علامات تبويب المتصفح، لا استيراد بيانات يدوية، لا تغيير السياق.

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