انتقل إلى المحتوى الرئيسي

خادم MCP ذاتي

للتكاملات المتقدمة يمكنك بناء خادم MCP خاص بك. هذا يمنحك سيطرة كاملة على الوظائف وهو مثالي للتكامل مع أنظمتك الخاصة أو التطبيقات غير المدعومة.

متى تخطط لخادم MCP خاص؟​

يكون خادم MCP خاص مناسبًا عندما:

  • تريد التكامل مع تطبيقك أو قاعدة بياناتك
  • التكامل المطلوب غير متاح في Zapier
  • لديك متطلبات أمان محددة
  • تحتاج إلى منطق معقد في الأدوات

المعرفة المطلوبة​

لبناء خادم MCP خاص تحتاج إلى:

  • خبرة برمجية (TypeScript/JavaScript أو Python)
  • معرفة بواجهات REST
  • أساسيات عن الخوادم والاستضافة

بروتوكول سياق النموذج​

بروتوكول سياق النموذج (MCP) هو معيار مفتوح طورته Anthropic. يمكن استخدام خوادم MCP مع:

  • AI School
  • ChatGPT
  • Claude
  • Visual Studio Code مع Copilot
  • تطبيقات أخرى متوافقة مع MCP

البدء السريع مع TypeScript​

1. إعداد المشروع​

mkdir mijn-mcp-server
cd mijn-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk

2. كود الخادم​

import { Server } from "@modelcontextprotocol/sdk/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";

const server = new Server({
  name: "mijn-server",
  version: "1.0.0",
});

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

// تنفيذ الأداة
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "mijn_tool") {
    const { parameter } = request.params.arguments;
    // نفّذ شيئاً بالمعامل
    return {
      content: [{ type: "text", text: `النتيجة: ${parameter}` }],
    };
  }
});

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

3. تشغيل الخادم​

npx ts-node server.ts

النقل HTTP لـ AI School​

يدعم AI School خوادم MCP عبر HTTP. يجب أن يوفر الخادم نقطة نهاية تقبل رسائل MCP:

import express from 'express';

const app = express();
app.use(express.json());

app.post('/mcp', async (req, res) => {
  const { method, params } = req.body;

  if (method === 'tools/list') {
    res.json({ tools: [...] });
  } else if (method === 'tools/call') {
    // معالجة استدعاء الأداة
    res.json({ content: [...] });
  }
});

app.listen(3000);

خيارات الاستضافة​

يجب أن يكون خادم MCP قابلاً للوصول عبر الإنترنت:

الخيارمناسب لـالتكلفة
Cloudflare Workersأحمال عمل خفيفةتوجد طبقة مجانية
Vercelخوادم TypeScriptتوجد طبقة مجانية
Railwayتطبيقات كاملةمن 5 دولار/شهر
AWS Lambdaحلول قابلة للتوسعالدفع حسب الاستخدام
خادم خاصتحكم كاملمتغير

الاتصال بـ AI School​

  1. قم بنشر خادمك إلى عنوان URL عام
  2. ادخل إلى لوحة التحكم في AI School
  3. انقر على الاتصالات → إضافة اتصال
  4. ادخل عنوان MCP الخاص بخادمك
  5. اضبط أي مصادقة مطلوبة

المصادقة​

يمكنك إضافة المصادقة إلى خادم MCP الخاص بك:

مصادقة مفتاح API​

app.post("/mcp", (req, res, next) => {
  const apiKey = req.headers["x-api-key"];
  if (apiKey !== process.env.API_KEY) {
    return res.status(401).json({ error: "Unauthorized" });
  }
  next();
});

في AI School اختر "API Key" كطريقة المصادقة.

OAuth 2.0​

للمصادقة الأكثر تعقيداً يمكنك تنفيذ OAuth 2.0. يدعم AI School OAuth 2.1 لخوادم MCP.

أمثلة وموارد​

خوادم MCP رسمية​

توثيق​

نصائح التطوير​

  1. ابدأ ببساطة: ابدأ بأداة واحدة وتوسع تدريجيًا
  2. اختبر محليًا: استخدم MCP Inspector لعملية التصحيح
  3. التسجيل: أضف تسجيلًا موسّعًا لعمليات استكاف الأخطاء
  4. التعامل مع الأخطاء: ارجع إلى رسائل خطأ واضحة
  5. معدّل الطلب: احمِ خادمك من التحميل الزائد

التكاملات الشائعة​

النظامالأدوات الممكنة
LVS (Magister, Somtoday)استعلام النتائج، عرض الجداول
أنظمة CRMاستعلام بيانات العملاء، إضافة ملاحظات
قواعد البياناتتشغيل الاستعلامات، إنشاء تقارير
تطبيقاتك الخاصةأي API تحتاج إلى كشْفها

مقالات ذات صلة​

  • [خادم MCP Zapier]./zapier-mcp-server - روابط سهلة بدون كود