إضافة الفلك إلى وكيلك الإصطناعي عبر MCP

إذا كنت تعمل مع MCP (Model Context Protocol) خلال العام الماضي، فمن المحتمل أنك رأيته. إنها معيار مفتوح من Anthropic لربط الأدوات الخارجية بنماذج الذكاء الاصطناعي. بعد بضعة أسطر من التكوين، يمكن لـ Claude الوصول إلى نظام الملفات، أو قاعدة البيانات، أو أي REST API.

في هذا الدليل، سنوضح لك كيفية إضافة حسابات التنجيم إلى وكيل الذكاء الاصطناعي عبر MCP — في أقل من 5 دقائق.

MCP هو بروتوكول يسمح لنماذج الذكاء الاصطناعي باستدعاء الأدوات. تخيل أنه “REST API لوكيل الذكاء الاصطناعي”:

• الخادم يعرض الأدوات (الحسابات، الاستعلامات، الإجراءات)
• العميل (Claude Desktop، Cursor، وكيل مخصص) يكتشفها ويستدعيها
• تقوم النموذج نفسها بتحديد متى تستخدم أي أداة بناءً على طلب المستخدم

يمكن أن تكون خوادم MCP محلية (تشغيلها كعملية فرعية) أو عن بعد (عبر HTTP). معظمها محلي ويتم نشرها عبر npm وتشغيلها باستخدام npx.

يعرض خادم MCP الخاص بـ AstroWay 25 أداة تغطي الحسابات التنجيمية الأساسية:

• natal_chart — خريطة الميلاد الكاملة
• synastry — توافق شخصين
• transits — الترانزيت الحالي على خريطة الميلاد
• daily_horoscope، weekly_horoscope، monthly_horoscope، yearly_horoscope
• interpret_natal، interpret_synastry، interpret_transits — تفسيرات الذكاء الاصطناعي
• human_design — خريطة Human Design الكاملة
• hd_incarnation_cross، hd_compatibility — ميزات Human Design
• 12 أداة أخرى تغطي التقدمات، solar returns، علم التنجيم الجغرافي، التثبيت

سجل حسابًا على astroway.info وأنشئ API key مجانيًا (10,000 رصيد/شهر، بدون بطاقة).

ملف claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

أضف خادم AstroWay:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

بعد إعادة التشغيل، سترى أيقونة مطرقة مع 25 أداة متاحة.

الآن، يمكنك التحدث مع Claude باللغة الطبيعية:

أنت: أنشئ خريطة ميلاد لشخص ولد في 14 يوليو 1990 الساعة 14:30 في كييف. ماذا تعني شمسه في السرطان في البيت العاشر؟

Claude: يستدعي natal_chart بالتنسيق المدخل، ثم interpret_placement. إليك خريطة الميلاد. الشمس في السرطان في البيت العاشر تشير إلى…

يقوم Claude تلقائيًا:

• بتحليل اللغة الطبيعية (المدينة → الإحداثيات)
• باختيار الأداة المناسبة
• بتنسيق الاستجابة

إذا كنت تبني وكيل ذكاء اصطناعي مخصصًا (ليس Claude Desktop)، يمكنك أيضًا استخدام خادم MCP. البروتوكول موثق:

import { spawn } from 'child_process';

const mcp = spawn('npx', ['@astroway/mcp'], {
  env: {
    ...process.env,
    ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
  },
  stdio: ['pipe', 'pipe', 'pipe'],
});

// تهيئة MCP
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// قائمة الأدوات
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// استدعاء أداة
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 3,
  method: 'tools/call',
  params: {
    name: 'natal_chart',
    arguments: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
  },
}) + '\n');

معظم أطر عمل الوكلاء (مثل LangChain، LlamaIndex وغيرها) تدعم MCP بشكل أصلي.

إذا لم تكن تريد تكاليف MCP الإضافية، يمكنك استدعاء HTTP API مباشرة من وكيلك:

async function callAstrowayTool(tool: string, input: object) {
  const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.ASTROWAY_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  return res.json();
}

// الاستخدام في حلقة الوكيل
const chart = await callAstrowayTool('chart', birthData);

مميزات MCP: أوصاف هيكلية للأدوات، اكتشاف تلقائي، معالجة موحدة للأخطاء. مميزات HTTP: أبسط، يعمل في أي مكان، بدون عمليات فرعية.

عندما يكون MCP مُعدًا، جرب في Claude:

1. «ما هو برجي اليومي؟ ولدت في 3 أكتوبر 1993 الساعة 6 صباحًا في نيويورك.»
2. «احسب نوع Human Design الخاص بي. ولدت في 22 أبريل 1987 الساعة 16:45 في لندن.»
3. «قارن توافق شخصين: أنا (14 يوليو 1990، كييف) وصديقتي (22 مارس 1992، باريس).»
4. «ما هي الترانزيتات الرئيسية بالنسبة لي اليوم؟ أعطِ تفسيرًا.»
5. «لا أعرف الوقت الدقيق لميلادي. ماذا يظهر تحليل الحساسية لنطاق ±30 دقيقة؟»

سيقوم Claude باختيار الأدوات المناسبة، واستدعاء عدة أدوات في سلسلة، وتنسيق الاستجابة بلغتك الطبيعية.

تحتوي أدوات تفسير الذكاء الاصطناعي الخاصة بـ AstroWay (interpret_*، *_horoscope) على حماية أمان مدمجة:

• لا توجد نصائح طبية أو قانونية أو مالية
• إخلاءات قانونية مُحقنة تلقائيًا
• تصفية المحتوى

عندما يعرض الوكيل نص التفسير للمستخدم، احتفظ بالإخلاء القانوني. يوجد في حقل disclaimer لكل استجابة ذكاء اصطناعي.

يتم احتساب استدعاءات MCP عبر نفس نظام الرصيد مثل HTTP. الاستعلامات البسيطة (10 رصيد) → خريطة (20) → توافق (50) → تفسير ذكاء اصطناعي (50).

للاستخدام الشخصي (مستخدم واحد يطرح أسئلة على Claude)، حوالي 200–500 رصيد شهريًا. حزمة مجانية كافية.

للوكيل الإنتاجي مع مئات المستخدمين، احسب حسب مزيج الendpoints. بوت الأبراج اليومية لـ 1,000 مستخدم = 1,000 × 20 × 30 = 600,000 رصيد/شهر → خطة Pro.

• MCP AstroWay على npm
• الاستخدامات العملية لـ AI Agents وMCP — دليل تكامل كامل
• API الأبراج وتفسيرات الذكاء الاصطناعي — صفحة المنتج
• البدء السريع — احصل على API key (مجاني، 10,000 رصيد/شهر)