بروتوكول السياق

⚙️ كيف يعمل MCP في Aura Work

خوادم MCP تدار بواسطة خدمة مساعد الإضافات (المنفذ 47824). عند إضافة خادم MCP:

1. 1. مساعد الإضافات يشغّل عملية الخادم (stdio) أو يتصل به (SSE)
2. 2. الخادم يعلن عن قدراته (أدوات، موارد، أوامر)
3. 3. هذه القدرات تُسجّل في محرك الوكيل
4. 4. عندما يحتاج الوكيل أداة، يمكنه الآن استدعاء أدوات خادم MCP
5. 5. كل استدعاء أداة يمر عبر بوابة الأذونات للموافقة

الوكيل يكتشف تلقائياً أدوات MCP المتاحة ويختارها عندما تكون مناسبة — لا تحتاج أن تخبره صراحةً باستخدام أداة MCP.

🔌 طرق النقل المدعومة

MCP يدعم آليتي نقل:

النقل	كيف يعمل	الأفضل لـ
stdio	الخادم يعمل كعملية فرعية. التواصل عبر stdin/stdout.	الأدوات المحلية، مغلفات CLI، التكاملات البسيطة
SSE	الخادم يعمل كخدمة HTTP. التواصل عبر Server-Sent Events.	الخدمات البعيدة، الخوادم في الحاويات

معظم خوادم MCP المجتمعية تستخدم stdio لأنه أبسط — لا حاجة لإعدادات الشبكة.

📦 تثبيت خوادم MCP

هناك ثلاث طرق لإضافة خوادم MCP:

الطريقة 1: Marketplace (موصى بها)

افتح لوحة الإضافات في التطبيق المكتبي، ابحث عن خادم MCP، واضغط تثبيت. marketplace يدير الإصدارات والتحديثات والتبعيات.

الطريقة 2: إعداد يدوي

أضف خادم يدوياً في الإعدادات → الإضافات → خوادم MCP:

{
  "name": "my-database-server",
  "command": "node",
  "args": ["path/to/mcp-server.js"],
  "env": { "DATABASE_URL": "postgresql://localhost/mydb" }
}

الطريقة 3: إعداد على مستوى المشروع

أضف خوادم MCP إلى ملف aura.jsonc في مشروعك:

{
  "mcp": {
    "test-project-server": {
      "type": "local",
      "command": ["node", "/path/to/test-mcp-server.js"],
      "enabled": true,
      "environment": { "TEST_ENV_VAR": "مرحباً" }
    }
  }
}

🔐 الأمان والأذونات

استدعاءات أدوات MCP تخضع لنفس نظام الأذونات مثل الأدوات المدمجة:

• موافقة لكل أداة — كل أداة MCP يمكن الموافقة عليها أو رفضها بشكل فردي
• تنفيذ معزول — خوادم MCP تعمل في عمليات معزولة
• تصريح بالأذونات — الخوادم يجب أن تعلن ما تحتاج الوصول إليه
• سجل التدقيق — جميع استدعاءات MCP مسجلة بالتفصيل

في وضع ask-first، سيُطلب منك التأكيد قبل كل استدعاء أداة MCP.

🛒 Marketplace

المتجر (registry/marketplace.json) يتضمن خوادم MCP إلى جانب المهارات والإضافات. كل إدخال يتضمن: بيان الخادم، وصف الأدوات، وصف مترجم بـ 20 لغة، معلومات الإصدار، وتقييم المخاطر.

🛠️ تطوير خوادم MCP

يمكنك إنشاء خوادم MCP خاصة بك باستخدام MCP SDK الرسمي:

// my-mcp-server.js
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server({
  name: "my-custom-server",
  version: "1.0.0"
}, { capabilities: { tools: {} } });

// تعريف أداة
server.setRequestHandler("tools/list", async () => ({
  tools: [{
    name: "my_tool",
    description: "تقوم بشيء مفيد",
    inputSchema: {
      type: "object",
      properties: {
        query: { type: "string", description: "نص الاستعلام" }
      },
      required: ["query"]
    }
  }]
}));

// معالجة استدعاءات الأدوات
server.setRequestHandler("tools/call", async (request) => {
  const { name, arguments: args } = request.params;
  if (name === "my_tool") {
    return { content: [{ type: "text", text: "النتيجة: " + args.query }] };
  }
});

// بدء الخادم
const transport = new StdioServerTransport();
await server.connect(transport);

راجع examples/mcp-server/ لمثال عملي كامل.

💡 خوادم MCP شائعة

الخادم	الغرض	النقل
filesystem	قراءة/كتابة الملفات، البحث	stdio
github	إدارة المستودعات و issues و PRs	stdio
postgres	استعلام قواعد بيانات PostgreSQL	stdio
slack	إرسال رسائل وقراءة القنوات	stdio
puppeteer	أتمتة المتصفح مع Chrome	stdio
brave-search	بحث الويب عبر Brave API	stdio

اعثر على المزيد في github.com/modelcontextprotocol/servers