كيفية استخدام FXMacroData مع Continue.dev (MCP)

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

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

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

الخطوة 1 إنشاء ملف تكوين خادم MCP

استمر في اكتشاف خوادم MCP من ملفات YAML (أو JSON) وضعت في .continue/mcpServers/ المجلد في الجذر من مساحة العمل الخاصة بك. إنشاء هذا المجلود إذا لم يكن موجودا، ثم إضافة ملف يسمى fxmacrodata.yaml.

mkdir -p .continue/mcpServers

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

name: FXMacroData MCP
version: 0.0.1
schema: v1
mcpServers:
  - name: FXMacroData
    type: streamable-http
    url: https://fxmacrodata.com/mcp

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

name: FXMacroData MCP
version: 0.0.1
schema: v1
mcpServers:
  - name: FXMacroData
    type: streamable-http
    url: https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY

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

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

name: FXMacroData MCP
version: 0.0.1
schema: v1
mcpServers:
  - name: FXMacroData
    type: stdio
    command: uvx
    args:
      - mcp-server-fxmacrodata
    env:
      FXMACRODATA_API_KEY: YOUR_API_KEY

الخطوة 2 إعادة تحميل استمر

بعد حفظ ملف YAML، اعيد تحميل امتداد استمر حتى يتم اختيار الخادم الجديد. افتح لوحة أوامر VS Code (Ctrl + Shift + P - لا ، لا Cmd+Shift+Pو أركض

Continue: Reload MCP servers

أو ببساطة اغلق و اعد فتح كود VS. استمر في المسح .continue/mcpServers/ و تسجيل أي ملفات YAML أو JSON يجد.

الخطوة 3 التبديل إلى وضع الوكيل وتحقق من الاتصال

افتح لوحة الجانب " استمر " ، و غير اختيار الوضع إلى عميل، ونوع:

Run the FXMacroData ping tool.

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

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

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

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

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

أنت تقوم ببناء إشارة التجارة في دفتر ملاحظات بايثون وتريد مقارنة فارق سعر الفائدة السياسي 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 ، أو عند بناء تخصيص @custom-context مقدم خدمة يمكنك استفسار 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 إلى Continue.dev في خطوتين: أنشأت ملف تكوين YAML في .continue/mcpServers/ و قد أكدت الاتصال مع ping من هنا، كل سؤال ماكرو تكتب في لوحة استمر في العميل يؤدي إلى مكالمة بيانات مباشرة لا توجد تغيير علامة تبويب المتصفح، لا توفر واردات بيانات يدوية.

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