كيفية توصيل FXMacroData إلى Claude / Claude Desktop (MCP)

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

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

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

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

يقرأ Claude Desktop تكوين خادم MCP من ملف JSON المخزن في مسار ثابت على جهازك. افتح (أو قم بإنشاء الملف في الموقع لنظام التشغيل الخاص بك:

على macOS يمكنك فتح الملف مباشرة من المحطة:

open -a "TextEdit" ~/Library/Application\ Support/Claude/claude_desktop_config.json

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

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

إلصق النموذج التالي في claude_desktop_config.json، لتحل محل YOUR_API_KEY مع مفتاح FXMacroData الفعلي:

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

- ... uvx القيادة تحميل وتشغيل mcp-server-fxmacrodata حزمة PyPI تلقائيًا في كل مرة يبدأ فيها Claude Desktop لا يوجد دليل pip install مطلوبة

إذا كان ملف التكوين الخاص بك لديه بالفعل mcpServers المفتاح مع الخوادم الأخرى، دمج fxmacrodata كتلة في الكائن الموجود:

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

الخطوة 3 إعادة تشغيل Claude Desktop

إغلاق كامل وإعادة فتح Claude Desktop حتى يتم اختيار التكوين الجديد. على macOS:

osascript -e 'quit app "Claude"' && sleep 2 && open -a Claude

على ويندوز، انقر بزر الماوس الأيمن على رمز كلود في علبة النظام، اختر أتركثم إعادة تشغيل كلود من قائمة البدء

بعد إعادة التشغيل، سيقوم مكتب (كلود) بإطلاق uvx mcp-server-fxmacrodata العملية الفرعية في الخلفية. uv لم يتم تثبيته بعد على جهازك، قد يظهر خطأ في Claude؛ uv أولاً مع pip install uv ثم إعادة تشغيل كلود

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

ابدأ محادثة جديدة في Claude Desktop واكتب:

استخدم أداة FXMacroData للتحقق من الاتصال.

كلود) سيتصل) ping أداة pong الإجابة في رد كلود تؤكد أن خادم MCP يعمل ويمكن الوصول إليه. إذا قال كلود أن الأداة غير متوفرة، فلتتحقق من جديد من صحة JSON (بدون فاصلة خلفية، وآليات صحيحة) وأن Claude Desktop تم إعادة تشغيله بالكامل.

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

بمجرد الاتصال، يمكن لـ (كلود) الاتصال مباشرة بأدوات FXMacroData التالية:

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

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

أنت تدرس عملية تداول محتملة على زوج الجنيه الإسترليني مقابل اليورو قبل قرار بنك إنجلترا التالي. في محادثة جديدة مع كلود ديسكتوب، اسأل:

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

(كلود) يتصل indicator_query مرتين (مرة واحدة لكل عملة) و forex مرة واحدة، ثم يجمع ملخص التجارة تحمل بالكامل من البيانات الحية.

# GBP policy rate
curl "https://fxmacrodata.com/api/v1/announcements/gbp/policy_rate?api_key=YOUR_API_KEY"

# JPY policy rate
curl "https://fxmacrodata.com/api/v1/announcements/jpy/policy_rate?api_key=YOUR_API_KEY"

# GBP/JPY spot rate
curl "https://fxmacrodata.com/api/v1/forex/GBP/JPY?api_key=YOUR_API_KEY"

ممثل indicator_query رد:

{
  "currency": "GBP",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-03-20", "val": 4.50, "announcement_datetime": 1742482200 },
    { "date": "2026-02-06", "val": 4.50, "announcement_datetime": 1738836000 },
    { "date": "2025-11-07", "val": 4.75, "announcement_datetime": 1731002400 },
    { "date": "2025-08-01", "val": 5.00, "announcement_datetime": 1722506400 }
  ]
}

مع أسعار الفائدة والسلسلة الفورية في متناول اليد، ينتج كلود تحليل نقل مبني على البيانات الحالية بدلا من المعرفة المجموعة التدريبية. أسعار العملة البريطانية و وثائق سعر الفائدة المحددة للين الياباني يظهر مخطط المؤشر الكامل إذا كنت ترغب في توسيع التحليل أكثر.

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

إذا كنت تفضل إدخال FXMacroData مباشرة إلى إشارة النظام Claude، أو استخدامه داخل برنامج برمجي بايثون يدعو Claude API، أو التجربة مع البيانات قبل إعداد MCP، فإن REST API هي أبسط مسار. تقبل كل نقطة نهاية مفتاح API معين.

استرداد بيانات المؤشر باستخدام Python

import requests

BASE = "https://fxmacrodata.com/api/v1"
KEY  = "YOUR_API_KEY"

# Latest EUR inflation series
resp = requests.get(
    f"{BASE}/announcements/eur/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"])

إدخال البيانات الحية في دعوة Claude API

يمكنك استرداد البيانات من FXMacroData في Python ومن ثم تمريرها إلى Claude عبر Anthropic SDK كجزء من رسالة المستخدم:

import anthropic
import requests

BASE    = "https://fxmacrodata.com/api/v1"
FX_KEY  = "YOUR_FXMACRODATA_API_KEY"
ANT_KEY = "YOUR_ANTHROPIC_API_KEY"

# Pull the latest USD non-farm payrolls
resp  = requests.get(f"{BASE}/announcements/usd/non_farm_payrolls",
                     params={"api_key": FX_KEY}, timeout=10)
nfp   = resp.json()["data"][:6]

client   = anthropic.Anthropic(api_key=ANT_KEY)
message  = client.messages.create(
    model   = "claude-opus-4-5",
    max_tokens = 1024,
    messages = [{
        "role":    "user",
        "content": f"Here are the last six USD non-farm payroll readings: {nfp}. "
                   "Summarise the trend and tell me what this implies for the Fed outlook.",
    }],
)
print(message.content[0].text)

قائمة كاملة بالعملات والمؤشرات المدعومة موجودة على /api-data-docs /أبي بياناتعلى سبيل المثال الرواتب غير الزراعية بالدولار و التضخم في اليورو صفحات تشمل مسارات نقطة النهاية الدقيقة، وصف الحقول، وأمثلة الاستجابات.

ملخص

لقد قمت بتوصيل FXMacroData إلى Claude Desktop بثلاث خطوات: فتح claude_desktop_config.json، أضاف كتلة خادم FXMacroData MCP مع uvxو أكدت على الصلة مع ping من هنا كل سؤال ماكرو تسأل في Claude Desktop يؤدي إلى مكالمة بيانات مباشرة لا يوجد تبديل علامة تبويب المتصفح، لا يوجد استيراد بيانات يدوية، لا توجد أرقام قديمة من مجموعة التدريب.

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