دليل النشر

ContextForge على VPS: بوابة MCP لوكلاء الذكاء الاصطناعي

انشر على VPS Cloud ←

ContextForge على VPS: بوابة MCP لوكلاء الذكاء الاصطناعي

كل وكيل ذكاء اصطناعي يحتاج إلى استدعاء أدواتك يطلب إعداده الخاص: خادم MCP لكل خدمة، يُعرَّف في كل عميل مع بيانات اعتماده. تجمع ContextForge، بوابة MCP مفتوحة المصدر من IBM، كل ذلك خلف عنوان واحد. يثبّتها هذا الدليل على خادم VPS باستخدام Docker Compose، ويغلقها برموز API، وينشرها عبر HTTPS خلف nginx، ويحوّل واجهة REST إلى أداة MCP ويربط بها عميلًا.

7 دقائق للقراءةعدد الخطوات: 3
المحتويات· ما الذي تفعله ContextForge1/12
  1. 01ما الذي تفعله ContextForge
  2. 02ما تقدّمه البوابة
  3. 03ربط كل أداة على حدة أو المرور عبر ContextForge
  4. 04المتطلبات
  5. 05تثبيت ContextForge باستخدام Docker Compose
  6. 06لا تعطّل المصادقة أبدًا
  7. 07نشر ContextForge عبر HTTPS مع nginx
  8. 08تسجيل الدخول وإنشاء رمز API
  9. 09تحويل واجهة REST إلى أداة MCP
  10. 10جمع الأدوات وربط عميل MCP
  11. 11النسخ الاحتياطي والتحديث
  12. 12التثبيت بنقرة واحدة على ServOrbit

ما الذي تفعله ContextForge

ContextForge بوابة لبروتوكول Model Context Protocol ‏(MCP)، وهو البروتوكول الذي يتيح لوكيل الذكاء الاصطناعي اكتشاف الأدوات واستدعاءها. تقف بين عملائك — مساعدي البرمجة وأطر الوكلاء والأتمتة — والأدوات التي يستخدمونها: خوادم MCP بعيدة، وواجهات REST أو gRPC قائمة.

تنشر IBM المشروع بترخيص Apache-2.0. يوفّر واجهة برمجية للإدارة، ولوحة ويب، وإدارة للمستخدمين والرموز، وخوادم افتراضية: مجموعات أدوات لكل منها عنوان MCP خاص. على خادم VPS، هي نقطة الدخول الوحيدة لوكلائك.

ما تقدّمه البوابة

  • عنوان واحد — يتصل عملاؤك بالبوابة، لا بكل أداة.
  • واجهات REST تصبح أدوات — عنوان وطريقة ومخطط إدخال، دون كتابة خادم MCP.
  • خوادم افتراضية — مجموعة أدوات لكل وكيل أو مشروع أو عميل.
  • الاتحاد — خوادم MCP بعيدة تُسجَّل وتُعرض في مكان واحد.
  • رموز API — رمز لكل عميل بتاريخ انتهاء، يُلغى كل واحد على حدة.
  • لوحة ويب — تُدار الأدوات والخوادم والرموز والمستخدمون من /admin.

ربط كل أداة على حدة أو المرور عبر ContextForge

مرّر الجدول أفقيًا

خادم MCP لكل أداةContextForge
إعداد العملاءأداة تُعرَّف في كل عميلعنوان واحد ورمز
بيانات اعتماد الخدماتمنسوخة في كل عميلتحفظها البوابة
واجهة REST قائمةخادم MCP يجب كتابتهتُعرَّف كأداة
سحب صلاحيةعميلًا عميلًاإلغاء رمز
الأدوات التي يراها الوكيلكل ما ضُبط فيهأدوات خادمه الافتراضي

المتطلبات

يكفي خادم VPS بنظام Ubuntu 24.04 بذاكرة 2 غيغابايت ومعالجين افتراضيين: مع عمليتي عمل تستهلك البوابة نحو 800 ميغابايت من الذاكرة. تتسع البيانات في قاعدة SQLite ببضعة ميغابايتات.

تحتاج إلى Docker مع إضافة Compose، وnginx وcertbot على الخادم، وjq لقراءة ردود الواجهة البرمجية، واسم (mcp.example.com في هذا الدليل) يشير إلى عنوان IP الخادم.

تثبيت ContextForge باستخدام Docker Compose

  1. توليد الأسرار

    في مجلد مخصص، اكتب ملف .env يتضمن اسم النطاق وكلمة مرور المسؤول وسرّين منفصلين: SECRET_KEY يوقّع الرموز، وENCRYPTION_KEY_HEX64 يشفّر بيانات اعتماد الخوادم التي تسجّلها. ترفض ContextForge الإقلاع بأسرار قصيرة جدًا أو متروكة بقيمتها النموذجية.

    mkdir -p /opt/contextforge && cd /opt/contextforge
    cat > .env <<EOF
    DOMAIN=mcp.example.com
    ADMIN_PASSWORD=$(openssl rand -base64 18)
    SECRET_KEY=$(openssl rand -hex 32)
    ENCRYPTION_KEY_HEX64=$(openssl rand -hex 32)
    EOF
    chmod 600 .env
  2. كتابة ملف docker-compose.yml

    تعمل الصورة بمستخدم غير مميز (uid 10001): تجعل خدمة contextforge-init المجلد قابلًا للكتابة قبل الإقلاع. يُغلق AUTH_REQUIRED وMCP_REQUIRE_AUTH الواجهة البرمجية ونقطة MCP، ولا يُنشر المنفذ إلا على الواجهة المحلية. أما DEFAULT_USER_PASSWORD، كلمة المرور المؤقتة للحسابات المنشأة دون كلمة مرور، فتُسحب عشوائيًا عند كل إقلاع.

    services:
      contextforge-init:
        image: ghcr.io/ibm/mcp-context-forge:v1.1.1
        user: "0:0"
        entrypoint: ["chown", "-R", "10001:10001", "/app/data"]
        restart: "no"
        volumes:
          - contextforge-data:/app/data
    
      contextforge:
        image: ghcr.io/ibm/mcp-context-forge:v1.1.1
        restart: unless-stopped
        depends_on:
          contextforge-init:
            condition: service_completed_successfully
        environment:
          HOST: "0.0.0.0"
          PORT: "4444"
          ENVIRONMENT: "production"
          APP_DOMAIN: "https://${DOMAIN}"
          ALLOWED_ORIGINS: "https://${DOMAIN}"
          DATABASE_URL: "sqlite:////app/data/mcp.db"
          CACHE_TYPE: "database"
          GUNICORN_WORKERS: "2"
          MCPGATEWAY_UI_ENABLED: "true"
          MCPGATEWAY_ADMIN_API_ENABLED: "true"
          AUTH_REQUIRED: "true"
          MCP_CLIENT_AUTH_ENABLED: "true"
          MCP_REQUIRE_AUTH: "true"
          EMAIL_AUTH_ENABLED: "true"
          PLATFORM_ADMIN_EMAIL: "[email protected]"
          PLATFORM_ADMIN_PASSWORD: "${ADMIN_PASSWORD}"
          JWT_SECRET_KEY: "${SECRET_KEY}"
          AUTH_ENCRYPTION_SECRET: "${ENCRYPTION_KEY_HEX64}"
        entrypoint: ["/bin/bash", "-c"]
        command:
          - |
            export DEFAULT_USER_PASSWORD="$$(python3 -c 'import secrets; print(secrets.token_urlsafe(24))')"
            exec ./docker-entrypoint.sh
        ports:
          - "127.0.0.1:4444:4444"
        volumes:
          - contextforge-data:/app/data
    
    volumes:
      contextforge-data: {}
  3. التشغيل والتحقق

    شغّل الحزمة ثم استعلم عن نقطة الصحة. في المرة الأولى تنشئ ContextForge قاعدتها وحساب المسؤول، وتصبح الحاوية healthy في أقل من دقيقة.

    docker compose up -d
    docker compose ps
    curl -s http://127.0.0.1:4444/health

    الرد المتوقع هو {"status":"healthy"}. أي مسار آخر، مثل /tools أو /version، يردّ بالرمز 401 دون رمز وصول.

لا تعطّل المصادقة أبدًا

بوابة MCP مفتوحة تمنح أي شخص الأدوات التي ربطتها بها — وبيانات الاعتماد المرافقة لها. أبقِ AUTH_REQUIRED وMCP_REQUIRE_AUTH على true، والمنفذ على 127.0.0.1، ودع nginx وحده في مواجهة الإنترنت.

نشر ContextForge عبر HTTPS مع nginx

أنشئ كتلة server في /etc/nginx/sites-available/ وفعّلها. للترويسة X-Forwarded-Proto أهميتها: تقارن لوحة الإدارة مصدر نموذج تسجيل الدخول بعنوان الطلب، وترفض الدخول إن اختلفا. ويسمح proxy_buffering off بمرور الردود المتدفقة لبروتوكول MCP.

server {
    server_name mcp.example.com;

    location / {
        proxy_pass http://127.0.0.1:4444;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
        proxy_read_timeout 300s;
    }
}

تحقق من الإعداد ثم اطلب الشهادة:

sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d mcp.example.com

تسجيل الدخول وإنشاء رمز API

افتح https://mcp.example.com/admin وسجّل الدخول بـ [email protected] وكلمة المرور الموجودة في ملف .env. تتيح لوحة الإدارة إنشاء الرموز، وكذلك الواجهة البرمجية. يعيد تسجيل الدخول رمز جلسة قصير المدة، يُستخدم لإنشاء رمز API مسمّى صالح لمدة 30 يومًا هنا:

SESSION=$(curl -s https://mcp.example.com/auth/email/login -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"YOUR_PASSWORD"}' | jq -r .access_token)
TOKEN=$(curl -s https://mcp.example.com/tokens -H "Authorization: Bearer $SESSION" -H "Content-Type: application/json" \
  -d '{"name":"agent-1","expires_in_days":30}' | jq -r .access_token)

أنشئ رمزًا لكل عميل أو وكيل: يمكنك إلغاء أحدها دون المساس بالبقية.

تحويل واجهة REST إلى أداة MCP

تُعرَّف أداة REST بعنوانها وطريقتها ومخطط معاملاتها. يعرض المثال أدناه واجهة zen العامة من GitHub، التي تعيد جملة ولا تنتظر أي معامل:

curl -s https://mcp.example.com/tools -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"tool":{"name":"github_zen","url":"https://api.github.com/zen","integration_type":"REST","request_type":"GET","input_schema":{"type":"object","properties":{}}}}' \
  | jq -r .id

يعرض الأمر معرّف الأداة. من جهة MCP يصبح اسمها github-zen. لواجهة داخلية، استبدل العنوان وصِف معاملاتها في input_schema: هذا المخطط هو ما يقرؤه الوكيل ليعرف كيف يستدعيها.

جمع الأدوات وربط عميل MCP

يجمع الخادم الافتراضي أدوات تحت عنوان MCP واحد. أنشئه بمعرّف الأداة:

curl -s https://mcp.example.com/servers -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"server":{"name":"demo","associated_tools":["TOOL_ID"]}}' | jq -r .id

ثم تحقق، كما يفعل العميل، من أن الأداة مدرجة:

curl -s https://mcp.example.com/servers/SERVER_ID/mcp -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json, text/event-stream" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

في عميل MCP، عرّف عنوان الخادم الافتراضي والرمز. يختلف الشكل الدقيق حسب العميل، ويقبل كثير منها مدخلًا من هذا النوع:

{
  "mcpServers": {
    "contextforge": {
      "type": "http",
      "url": "https://mcp.example.com/servers/SERVER_ID/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

النسخ الاحتياطي والتحديث

ما يجب نسخه: المجلد contextforge-data الذي يحوي قاعدة SQLite — الأدوات والخوادم والمستخدمين والرموز — وملف .env. دون ENCRYPTION_KEY_HEX64 لا يمكن قراءة بيانات الاعتماد المشفّرة في القاعدة. أوقف الخدمة أثناء النسخ:

cd /opt/contextforge
docker compose stop contextforge
docker compose cp contextforge:/app/data ./backup-$(date +%F)
docker compose start contextforge

للتحديث، غيّر وسم الصورة في الخدمتين بعد قراءة ملاحظات الإصدار، ثم:

docker compose pull
docker compose up -d

تطبّق ContextForge ترحيلات قاعدتها عند الإقلاع: خذ النسخة الاحتياطية قبل ذلك.

التثبيت بنقرة واحدة على ServOrbit

على خادم ServOrbit تُثبَّت ContextForge من المتجر: ينشر السكربت الصورة الرسمية، ويولّد كلمة مرور المسؤول والأسرار، ويُغلق النسخة أمام أي طلب دون رمز، ويضبط nginx عبر HTTPS. العنوان نطاق فرعي من أحد نطاقاتك أو النطاق الفرعي المجاني للخادم، مع الشهادة، وتظهر كلمة المرور في مساحة العميل.

شارك هذا المقالservorbit.com/ma-ar/المدونة/استضافة-contextforge-على-vps