ما الذي تفعله 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
توليد الأسرار
في مجلد مخصص، اكتب ملف
.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كتابة ملف 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: {}التشغيل والتحقق
شغّل الحزمة ثم استعلم عن نقطة الصحة. في المرة الأولى تنشئ 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