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

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

في هذا البوست - كيف تضيف حسابات فلكية إلى وكيل AI عبر MCP. الوقت أقل من 5 دقائق.

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

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

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

MCP-сервер AstroWay يطرح أداة واحدة لكل عملية API، 735 في حزمة npm و843 على الخادم المستضاف، بأسماء على شكل astroway_<група>_<операція>:

• astroway_western_chart والأدوات المجاورة للخرائط، العبوريات، التقدمات والعودة
• astroway_relational_* للتوافق (سيناستري)، المركب والخرائط الجماعية
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: تفسيرات AI
• مجموعات Human Design، الفيدية، الصينية، الإغريقية، التارو وعلم الأعداد

لتقليل القائمة، اربط خادم نطاق واحد بدلًا من الفهرس الكامل، انظر إعدادات MCP

سجّل على astroway.info وأنشئ مفتاح API مجاني (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"
      }
    }
  }
}

بعد إعادة التشغيل، أدوات AstroWay ستظهر في قائمة الأدوات داخل حقل إدخال الدردشة.

الآن فقط تكلم مع Claude بلغة طبيعية:

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

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

Claude نفسه:

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

إذا كنت تبني وكيل AI مخصص (ليس 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 initialize
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// List the tools
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Call a tool
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();
}

// Use in your agent loop
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 نفسه يختار الأدوات اللازمة، يستدعي عدة أدوات متسلسلة وينسق الرد بلغة بشرية.

أدوات التفسير AI من AstroWay (interpret_*, *_horoscope) تحتوي على حواجز أمان مدمجة:

• لا نصائح طبية، قانونية أو مالية
• إخلاءات مسؤولية تُضاف تلقائيًا
• تصفية المحتوى

عندما يعرض الوكيل نص التفسير للمستخدم - احفظ إخلاء المسؤولية. هو موجود في حقل disclaimer لكل رد AI.

استدعاءات MCP تمر عبر نفس نظام الائتمان كما هو في HTTP. استعلامات بسيطة (10 ائتمانات) → خريطة (20) → سيناستري (50) → تفسير AI (50).

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

لوكيل إنتاجي لمئات المستخدمين - احسب بناءً على مزيج النقاط النهاية. بوت Daily-horoscope لـ 1 000 مستخدم = 1 000 × 20 × 30 = 600 000 ائتمان/شهر → خطة Pro.

• AstroWay MCP في npm
• AI-وكيل و MCP: حالة استخدام: دليل تكامل كامل
• Horoscope & AI Interpretations API: صفحة المنتج
• بدء سريع: احصل على مفتاح API (مجاني، 10 000 ائتمان/شهر)