MCP - الاتصال ب Claude / Cursor

يعرض خادم بروتوكول سياق النموذج (MCP) الخاص بـ AstroWay جميع 771 نقطة نهاية كأدوات لوكيل الذكاء الاصطناعي. وضعان - كلاهما مدعوم أصلاً من قبل جميع العملاء المتوافقين مع MCP.

الوضع	URL / الأمر	متى تختار
HTTP المستضاف	https://mcp.astroway.info/mcp	Claude Web (claude.ai في المتصفح)، أو Claude Desktop / Cursor / Code newcomers بدون npm، أو عندما تريد تثبيتًا صفريًا
Stdio (npm)	npx @astroway/mcp	لمستخدمي Cursor المتقدمين، التطوير المحلي، المهتمين بالخصوصية (المفتاح لا يغادر جهازك أبدًا)، جاهز للعمل دون اتصال

تستخدم نقطة النهاية المستضافة وحزمة npm نفس كتالوج الأدوات (يتم إنشاؤه من /v1/openapi.json واحد). المصادقة: نفس مفتاح API aw_test_* / aw_live_* - في الوضع المستضاف يتم إرساله عبر ترويسة Authorization: Bearer …، وفي وضع stdio يتم إرساله عبر متغير البيئة ASTROWAY_API_KEY.

المصدر: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · مستضاف: mcp.astroway.info/health

المستضاف (mcp.astroway.info) - تثبيت صفري

ابدأ بسرعة بدون npm - اختر عميلك. قبل التثبيت، احصل على مفتاحك من api.astroway.info/dashboard/sign-up (10,000 رصيد/شهر مجانًا).

Cursor (نقرة واحدة)

اضغط على الزر - سيفتح Cursor، ويطلب منك التأكيد، ويضيف الإدخال تلقائيًا:

تثبيت في Cursor ←

الخطوة الثانية إلزامية - وإلا فلن يعمل

لا يستطيع Cursor استبدال السر من الرابط العميق - سيتم كتابة الحرف Bearer YOUR_API_KEY في ~/.cursor/mcp.json، والذي يرد عليه الخادم بـ 403 invalid_format.

بعد النقر على الزر:

1. إعدادات Cursor (⚙️ الزاوية العلوية اليمنى) ← الأدوات و MCP ← ابحث عن astroway-hosted في القائمة.
2. اضغط على النقاط الثلاث (⋯) بجانب الخادم ← تعديل التكوين.
3. في حقل Authorization، استبدل Bearer YOUR_API_KEY بـ Bearer aw_test_… (أو aw_live_…) - مفتاحك الحقيقي من لوحة التحكم.
4. احفظ ← أعد فتح قائمة MCP ← تأكد من أن الحالة ممكنة + نقطة خضراء + عداد 780+ أداة ممكنة.

بدلاً من ذلك - قم بتحرير الملف مباشرة: ~/.cursor/mcp.json (headers.Authorization).

ملاحظة

يفرض Cursor حدًا على طول الأسماء: server_name:tool_name ≤ 60 حرفًا. يتم تصفية حوالي 90 من أصل 780+ أداة (معظمها من مجموعات hellenistic_*، psychological_*، zi_wei_*، zodiac_*، و numerology_*) بواسطة Cursor ولن تكون متاحة عبر LLM. يعمل حوالي 690 أداة أخرى. لا يوجد مثل هذا الحد في Claude Desktop - الكتالوج كامل.

Claude Desktop

الإعدادات ← المطور ← تحرير التكوين يفتح claude_desktop_config.json. يقوم هذا الملف بتشغيل الأوامر المحلية فقط: يتم تخطي الإدخال الذي يحتوي على url فقط مع رسالة “تعذر تحميل بعض خوادم MCP”. يتصل الخادم المستضاف عبر جسر mcp-remote، وهو يتطلب Node.js:

{
  "mcpServers": {
    "astroway-hosted": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer aw_live_..." }
    }
  }
}

أغلق Claude Desktop بالكامل (Cmd+Q) وافتحه مرة أخرى. المفتاح موجود في env، لأن Claude Desktop على Windows يقسم الوسيطة عند المسافة بعد Bearer.

يقبل مربع الحوار إضافة موصل مخصص في الإعدادات ← الموصلات اسمًا وعنوان URL فقط، ولا يوجد حقل لترويسة Authorization فيه، لذلك لا يمكن تمرير مفتاح AstroWay من خلاله حاليًا.

تكوين JSON (يدوي)

لـ Cursor و Cline و Continue و Windsurf، التي تقبل url بعيدًا مباشرة:

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

مسارات التكوينات:

• Cursor: ~/.cursor/mcp.json (عالميًا) أو .cursor/mcp.json (في مساحة العمل)
• Cline (VS Code): .cline/mcp.json في جذر مساحة العمل
• Continue: ~/.continue/config.json (كتلة mcpServers)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

بعد التعديل، أعد تشغيل العميل بالكامل (Cmd+Q ← افتح مرة أخرى).

التحقق

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

في العميل - اطلب: “List 5 AstroWay tool names from astroway-hosted”. يجب أن يعيد أسماء مثل astroway_western_chart، astroway_horoscope_daily، astroway_vedic_panchang_full، …

حدود المعدل

نقطة النهاية المستضافة محمية بحد ثلاثي المستويات: طبقة Cloudflare DDoS + وكيل الحافة 120 طلب/دقيقة/IP + سلة في الذاكرة 60/60 ثانية/(IP+key). عملاء MCP الحقيقيون (Claude Desktop، Cursor) لا يقتربون من هذه الحدود - فهم لا يقومون بطلبات متقطعة. إذا كانت أتمتتك / CI تتطلب أكثر من 120 طلب/دقيقة - استخدم وضع stdio (لا توجد حدود هناك، فهو يتصل مباشرة عبر api.astroway.info/v1/* بحد المعدل الخاص بخطتك).

ماذا لو كان mcp.astroway.info غير متاح مؤقتًا

إذا أعادت نقطة النهاية المستضافة رمز 5xx، فسيرى عميل MCP خطأ عند tools/list. هذا لا يؤثر على عملاء stdio - فهم يقومون بتشغيل حزمة npm محلية تتصل مباشرة بـ api.astroway.info/v1/* بدون طبقة مستضافة وسيطة.

حل بديل للتكاملات الحرجة: أضف خادم MCP ثاني إلى التكوين بوضع stdio - سيستخدمه العميل تلقائيًا إذا لم تستجب نقطة النهاية المستضافة لـ tools/list:

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

يمكن رؤية وقت تشغيل نقطة النهاية المستضافة الفعلي على status.astroway.info. يتم نشر الحوادث التي تزيد مدتها عن 5 دقائق كتحليل بعد الوفاة في غضون 5 أيام عمل (وفقًا لـ /sla/).

Stdio (npm) - للتطوير المحلي

@astroway/mcp - حزمة npm، التي يتم تشغيلها محليًا كعملية فرعية. حزمة npm واحدة، تكامل أصلي مع Claude Desktop و Cursor وأي عميل متوافق مع MCP.

كيف يعمل

يتم إنشاء قائمة الأدوات في وقت البناء من مواصفات OpenAPI الحية (api.astroway.info/v1/openapi.json). يستوعب كل إصدار من الحزمة تلقائيًا جميع نقاط النهاية الجديدة - لا يلزم صيانة يدوية.

تصبح كل نقطة نهاية أداة من النوع:

• tools/list يعيد الوصف ومخطط الإدخال (مع مثال لهيكل الطلب)
• tools/call يقوم بطلب HTTP POST إلى https://api.astroway.info/v1/<path> باستخدام ASTROWAY_API_KEY الخاص بك
• يتم إرجاع الاستجابة إلى الوكيل كـ JSON منظم

يتم شحن كل إصدار أيضًا مع إثبات SLSA (معتمد من Sigstore) - وهذا يضمن أن حزمة npm مبنية بالضبط من الالتزام في المستودع العام.

التثبيت

Claude Desktop (macOS)

أضف إلى ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

أعد تشغيل Claude Desktop. سيظهر مؤشر 🛠️ في الشريط أسفل الدردشة مع عدد الأدوات المحملة.

Cursor

أضف إلى ~/.cursor/mcp.json:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

يعمل نفس الأمر npx @astroway/mcp في كل عميل متوافق مع MCP. التكوين متطابق - يتغير مسار الملف فقط:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

العميل	مسار التكوين
Cline (VS Code)	.cline/mcp.json في جذر مساحة العمل
Continue	~/.continue/config.json (تحت mcpServers)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	علامة المعاينة ← mcp.json في مساحة العمل
VS Code MCP extension	~/.vscode/mcp.json

عملاء MCP الآخرون

شغّل كخادم stdio:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

نصيحة

للحصول على المفتاح - اذهب إلى api.astroway.info/dashboard/sign-up. الطبقة المجانية - 10 000 رصيد/شهر، بدون بطاقة.

الخصوصية - من الإصدار 1.0.0+

خادم MCP هذا لا يرسل أي شيء إلى AstroWay باستثناء استدعاءات API نفسها التي تطلب منه تنفيذها. لا يوجد قياس عن بعد، لا تحليلات، لا مفتاح تشغيل/إيقاف للموافقة - صمت افتراضيًا.

تحمل الطلبات الصادرة ترويستين تعريفيتين لتمكين الواجهة الخلفية لـ AstroWay من التمييز بين حركة مرور MCP و HTTP المباشر في سجلاتها الخاصة:

• User-Agent: astroway-mcp/<version> (Node/<node-version>)
• X-Astroway-Channel: mcp

لا يحتوي أي منهما على معرف جلسة، أو بصمة جهاز، أو أي شيء شخصي. هذه هي دلالات User-Agent القياسية - كل أداة CLI ترسل معلومات مماثلة.

تسجيل المجموعات الفرعية - من الإصدار 1.0.0+

إذا كنت تستخدم جزءًا فقط من الكتالوج - قم بتسجيل مجموعة فرعية للحفاظ على نافذة سياق LLM مدمجة:

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

المجموعات الشائعة: western، vedic، tarot، numerology، hd (Human Design)، relational (synastry/composite/davison)، prognostics (transits/progressions/returns)، aspects، horary، geo، chinese، bazi، mayan، iching، runes، geomancy. شغّل npx @astroway/mcp --list-tools لرؤية المجموعة الكاملة.

ASTROWAY_READONLY=1 يتخطى ثلاث مجموعات تستدعي LLM داخليًا (ai، horoscope، reports) - مفيد عندما تريد رياضيات خرائط حتمية نقية دون إنفاق أرصدة على توليد النص.

التزام الاستقرار - من الإصدار 1.0.0+

• الكتالوج مجمد لمدة الجلسة. أكثر من 780 أداة، 12 موجهًا، 14 موردًا مدمجة في حزمة npm المنشورة في وقت البناء - لا يتغير شيء أثناء الاتصال. إذا قام عميلك بتخزين tools/list مؤقتًا بعد الاستدعاء الأول - فإنه يظل صحيحًا طوال الجلسة.
• معرفات الأدوات مستقرة ضمن الإصدار الرئيسي. لن يتم إعادة تسمية أو حذف الاسم تحت astroway_<group>_<tool> ضمن v1.x بدون ملاحظة إهمال في CHANGELOG.md وتوفر متوازي لإصدار ثانوي واحد.
• شكل إدخال الأداة مستقر ضمن الإصدار الثانوي. التضييق (regex، range، enum) يأتي في التصحيحات؛ إضافة حقل إلزامي يتطلب زيادة في الإصدار الثانوي.
• تحديث الكتالوج: عن طريق إعادة التثبيت. npm i -g @astroway/mcp@latest (أو صيغة npx -y @astroway/mcp في تكوينك) تسحب المجموعة الحالية عند البدء التالي.

أمثلة على الموجهات

بعد توصيل الخادم، اطلب من الذكاء الاصطناعي:

الخريطة الفلكية

احسب خريطتي الفلكية - ولدت في 15 مارس 1990، الساعة 14:30، كييف. صف الشمس والقمر والطالع وابحث عن الجوانب القريبة.

سيستدعي Claude أداة chart بمعلماتك، ويحصل على JSON منظم، ويصف الخريطة بالكلمات.

العبور الفلكي

ما هي العبورات الفلكية الهامة للكواكب البطيئة التي ستؤثر على خريطتي الفلكية خلال عام 2027؟

يقوم Claude باستدعاءين للأداة: أولاً transits (لقطة حالية)، ثم transit-calendar (نطاق). يفسر الاتجاهات.

الماها داشا الفيدية

شغّل Vimshottari Mahadasha لشخص ولد في 22.07.1985 الساعة 06:45 في مومباي. في أي فترة يقع هذا الشخص الآن؟

عبر أداة vedic/dashas/vimshottari/maha - الطابع الزمني الدقيق بتوقيت UTC للفترة الحالية.

التوافق الفلكي

قارن خريطتين: أ - 10.06.1988 09:15 لندن، ب - 22.11.1991 22:40 برلين. ما هي أقوى الجوانب المتقاطعة؟

أداة synastry مع كتلتين chart + تفسير درجة التوافق.

التاروت

اسحب 3 بطاقات Rider-Waite-Smith: الماضي - الحاضر - المستقبل. السؤال: “هل يجب أن أقبل الوظيفة الجديدة؟”. Seed = 42.

tarot/rider-waite/spread مع seed ثابت للتكرارية.

قائمة جميع الأدوات

بعد الاتصال، اسأل Claude:

اذكر جميع أدوات astroway.

أو من سطر الأوامر:

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

التكوين

المتغير	الافتراضي	الوصف	من الإصدار
ASTROWAY_API_KEY	(إلزامي)	مباشر: aw_live_.... بيئة الاختبار: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	تجاوز لبيئات الاستضافة الذاتية/التجريبية.	0.1.0
ASTROWAY_TOOL_GROUPS	(جميع المجموعات)	بادئات مفصولة بفاصلة لتقييد الكتالوج (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 يتخطى المجموعات المدعومة بـ LLM (ai، horoscope، reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug - مستوى التسجيل إلى stderr.	0.8.0
LOG_FILE	(لا يكتب)	مسار الملف لتكرار السجلات.	0.8.0
MCP_FLAT_TOOLS	0	1 يعيد أسماء مسطحة قبل الإصدار 0.9 (chart بدلاً من astroway_western_chart). قديم.	0.9.0

لماذا MCP، وليس التكامل المباشر

سيقول LLM العام (بدون أساس) “في مكان ما في يوليو، سيشكل زحل مثلثًا مع كوكب المشتري الخاص بك” - بدون تاريخ دقيق، مع انحراف ±15 يومًا. يقوم وكيل MCP بإجراء tool_use POST /v1/transits ويعيد طابعًا زمنيًا بتوقيت UTC بالثانية، بناءً على Swiss Ephemeris الحقيقي.

الميزة ليست في LLM، بل في ضمان أن الرياضيات حقيقية - وليست مختلقة.

توزيع الحزمة

• 📦 قائمة mcp.so: mcp.so/server/astroway-mcp/astroway
• 🌐 mcpservers.org: بانتظار الموافقة (اعتبارًا من مايو 2026)
• ✨ awesome-mcp-servers (punkpeye): PR #5972

روابط

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 وثائق API: /docs/api/
• 🔑 التسجيل: /dashboard/sign-up
• 💰 التسعير: /pricing/
• 🌐 المستودع العام (MIT): github.com/astroway/astroway-mcp