كيفية تثبيت وتكوين خادم MongoDB MCP

في المشهد المتطور باستمرار لتطوير البرمجيات، لم يعد دمج الذكاء الاصطناعي مفهوماً مستقبلياً بل واقعاً حاضراً. أصبحت الأدوات المدعومة بالذكاء الاصطناعي لا غنى عنها للمطورين بشكل متزايد، حيث تبسط سير العمل وتعزز الإنتاجية. إدراكاً لهذا الاتجاه، قدمت MongoDB أداة رائدة تسد الفجوة بين قاعدة بياناتك والذكاء الاصطناعي: خادم بروتوكول سياق نموذج MongoDB (MCP). يقدم هذا البرنامج التعليمي دليلاً شاملاً خطوة بخطوة لتثبيت وتكوين خادم MongoDB MCP، مما يمكّنك من الاستفادة من الإمكانات الكاملة للذكاء الاصطناعي في بيئة التطوير الخاصة بك.

ما هو خادم MongoDB MCP؟

خادم MongoDB MCP هو أداة جديدة قوية مصممة لربط تطبيقات MongoDB الخاصة بك بمجموعة متنوعة من العملاء المدعومين بالذكاء الاصطناعي الذين يدعمون بروتوكول سياق النموذج (MCP). سواء كنت تستخدم MongoDB Atlas، قاعدة البيانات السحابية المُدارة بالكامل، أو إصدار Community أو Enterprise Advanced المستضاف ذاتياً، يمكّن خادم MCP التفاعل السلس مع بياناتك باستخدام اللغة الطبيعية. هذا يعني أنه يمكنك إجراء مجموعة واسعة من عمليات قاعدة البيانات، من استعلامات البيانات البسيطة إلى المهام الإدارية المعقدة، كل ذلك من خلال أوامر بديهية ومحادثة ضمن أدوات تطوير الذكاء الاصطناعي المفضلة لديك.

MCP هو معيار مفتوح، قدمته Anthropic في البداية، يكتسب زخماً سريعاً لقدرته على إنشاء طبقة اتصال موحدة بين وكلاء الذكاء الاصطناعي وأنظمة البيانات المتنوعة. من خلال تطبيق هذا البروتوكول، تضمن MongoDB أن مستخدميها يمكنهم البقاء في طليعة التطوير المدفوع بالذكاء الاصطناعي. يسهل خادم MCP قناة اتصال ثنائية الاتجاه، مما يسمح لك ليس فقط بالاستعلام عن بياناتك ولكن أيضاً بتزويد نماذج اللغة الكبيرة (LLMs) الخاصة بك بأحدث المعلومات وأكثرها صلة بالسياق من قاعدة بياناتك. هذا يغير قواعد اللعبة لمهام مثل استكشاف البيانات، وإدارة قاعدة البيانات، وتوليد التعليمات البرمجية الواعية بالسياق.

يدعم خادم MongoDB MCP نظاماً متنامياً من عملاء MCP، بما في ذلك:

• Windsurf: محرر أكواد أصيل للذكاء الاصطناعي حيث يتوفر خادم MCP جاهزاً للاستخدام.
• Cursor: محرر أكواد شائع مدعوم بالذكاء الاصطناعي.
• GitHub Copilot في Visual Studio Code: جلب قوة قاعدة بياناتك إلى بيئة التطوير المتكاملة (IDE) الأكثر شيوعاً في العالم.
• Anthropic's Claude: تفاعل مع قاعدة بياناتك مباشرة من تطبيق سطح المكتب Claude.

هيا بنا نبدأ!

المتطلبات الأساسية

قبل أن نتعمق في عملية التثبيت، هناك بعض المتطلبات الأساسية التي تحتاج إلى توفرها:

• Node.js و npx: خادم MongoDB MCP هو تطبيق Node.js ويتم تثبيته وتشغيله عادة باستخدام npx، مشغل حزم Node.js. ستحتاج إلى تثبيت Node.js الإصدار 18 أو أعلى على نظامك. يمكنك التحقق من إصدار Node.js الخاص بك بفتح طرفية أو موجه أوامر وتشغيل node -v.
• سلسلة اتصال MongoDB أو بيانات اعتماد Atlas API: للاتصال بقاعدة بياناتك، يحتاج خادم MCP إما إلى سلسلة اتصال MongoDB قياسية أو بيانات اعتماد API لحساب MongoDB Atlas الخاص بك.
• سلسلة الاتصال: هذا هو تنسيق URI القياسي للاتصال بمثيل MongoDB. يتضمن اسم المستخدم وكلمة المرور والمضيف والمنفذ واسم قاعدة البيانات.
• بيانات اعتماد Atlas API: إذا كنت تستخدم MongoDB Atlas، يمكنك إنشاء حساب خدمة بالصلاحيات اللازمة واستخدام معرف عميل API وسر العميل (Client Secret) المُنشأ للمصادقة. هذه الطريقة مطلوبة لاستخدام أدوات Atlas المحددة.
• عميل MCP: ستحتاج إلى تثبيت أحد عملاء MCP المدعومين، مثل Cursor، أو Claude Desktop، أو Visual Studio Code مع إضافة GitHub Copilot.
• Docker (اختياري): إذا كنت تفضل تشغيل خادم MCP في بيئة حاويات (containerized)، فستحتاج إلى تثبيت Docker و Docker Compose. هذا مفيد بشكل خاص لاختبار بيئة Sandbox المحلية ولتجنب تثبيت Node.js محلياً.

التثبيت والتكوين

تختلف عملية تثبيت وتكوين خادم MongoDB MCP قليلاً اعتماداً على عميل MCP الذي تستخدمه. جوهر العملية يتضمن إضافة تكوين JSON إلى ملف إعدادات عميلك يخبره بكيفية تشغيل خادم MCP والتواصل معه.

الأمر الأساسي لتشغيل الخادم هو npx -y mongodb-mcp-server. العلم -y يؤكد تلقائياً تثبيت الحزمة إذا لم تكن موجودة بالفعل.

الإعداد في Cursor

Cursor هو محرر أكواد يعتمد على الذكاء الاصطناعي أولاً ويكتسب شعبية سريعة. إليك كيفية إعداد خادم MongoDB MCP في Cursor:

1. افتح إعدادات Cursor: قم بتشغيل Cursor وانقر على أيقونة الترس في الزاوية العلوية اليمنى من النافذة لفتح الإعدادات.
2. انتقل إلى قسم MCP: في لوحة الإعدادات على اليسار، انقر على "MCP".
3. أضف خادم MCP عام جديد: انقر على زر "Add new global MCP server". سيؤدي هذا إلى فتح ملف تكوين JSON.
4. أدخل التكوين: انسخ والصق تكوين JSON التالي في الملف. ستحتاج إلى تخصيص هذا باستخدام تفاصيل اتصالك.

<!-- end list -->JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "environments": [
      {
        "name": "ATLAS_API_CLIENT_ID",
        "value": "your-atlas-api-client-id"
      },
      {
        "name": "ATLAS_API_CLIENT_SECRET",
        "value": "your-atlas-api-client-secret"
      }
    ]
  }
}

إذا كنت تستخدم سلسلة اتصال بدلاً من بيانات اعتماد Atlas API، فسيبدو تكوينك كالتالي:JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

1. احفظ التكوين: احفظ الملف. سيتمكن Cursor الآن من استخدام خادم MongoDB MCP الجديد الخاص بك.

بعد تكوين الخادم، يمكنك الآن التفاعل مع قاعدة بياناتك باستخدام اللغة الطبيعية داخل Cursor. إذا استخدمت بيانات اعتماد Atlas API الخاصة بك، فستتمكن من الوصول إلى مجموعة غنية من أدوات Atlas المحددة، مما يسمح لك بإنشاء مجموعات مجانية، وإدارة قوائم الوصول، وإنشاء مستخدمي قاعدة البيانات، وغير ذلك الكثير. إذا استخدمت سلسلة اتصال، فستتمكن من الوصول إلى أدوات إدارة قاعدة البيانات، مثل سرد قواعد البيانات والمجموعات، وإدارة الفهارس، وإجراء عمليات CRUD (إنشاء، قراءة، تحديث، حذف).

الإعداد في Claude Desktop

إذا كنت من مستخدمي Claude من Anthropic، يمكنك دمج خادم MongoDB MCP مباشرة في تطبيق سطح المكتب Claude.

1. افتح ملف التكوين: ابدأ تطبيق Claude Desktop، ثم انتقل إلى Settings > Developer > Edit Config. سيؤدي هذا إلى فتح ملف claude_desktop_config.json في محرر النصوص الافتراضي الخاص بك. عادة ما يكون موقع هذا الملف هو:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

1. أضف تكوين خادم MCP: أضف التكوين التالي إلى الكائن mcpServers في ملف JSON.

<!-- end list -->JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/test"
      ]
    }
  }
}

تأكد من استبدال سلسلة الاتصال النائبة بسلسلة الاتصال الفعلية الخاصة بك.

1. أعد تشغيل Claude Desktop: أغلق وأعد تشغيل تطبيق Claude Desktop.
2. تحقق من الخادم: انقر على أيقونة المطرقة في Claude Desktop. يجب أن يكون خادم MongoDB MCP الآن مدرجاً كأداة متاحة.

الإعداد في Visual Studio Code مع GitHub Copilot

للملايين من المطورين الذين يستخدمون Visual Studio Code، يمكن دمج خادم MongoDB MCP مع GitHub Copilot لجلب تفاعل قاعدة البيانات باللغة الطبيعية إلى بيئة التطوير المتكاملة (IDE) المفضلة لديك.

1. افتح لوحة الأوامر (Command Palette): افتح VS Code واضغط على Ctrl+Shift+P (أو Cmd+Shift+P على macOS) لفتح لوحة الأوامر.
2. أضف خادم MCP جديد: اكتب "mcp" في لوحة الأوامر واختر "MCP: Add Servers".
3. اختر Command Standard I/O: اختر "Command Standard I/O" كنوع للخادم.
4. أدخل الأمر: أدخل الأمر npx -y mongodb-mcp-server وأعطِ خادمك اسماً، على سبيل المثال، "mongodb".
5. كون في settings.json: سيؤدي هذا إلى فتح ملف settings.json الخاص بك. هنا، يمكنك إضافة وسيطاتك ومتغيرات البيئة. على سبيل المثال، لاستخدام سلسلة اتصال:

<!-- end list -->JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

أو، لاستخدام بيانات اعتماد Atlas API:JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "options": {
      "env": {
        "ATLAS_API_CLIENT_ID": "your-atlas-api-client-id",
        "ATLAS_API_CLIENT_SECRET": "your-atlas-api-client-secret"
      }
    }
  }
}

1. ابدأ تشغيل الخادم: يمكنك بدء تشغيل الخادم بالنقر على زر "Start" الذي يظهر فوق اسم الخادم في ملف settings.json الخاص بك، أو بفتح لوحة الأوامر، والبحث عن "MCP: List Servers"، واختيار خادمك، ثم اختيار "Start Server".

بمجرد تشغيل الخادم، يمكنك استخدام وضع وكيل GitHub Copilot للتفاعل مع بيئة MongoDB Atlas الخاصة بك. يمكنك أن تطلب منه سرد مشاريعك، وإنشاء مجموعات جديدة، وإدارة المستخدمين، وغير ذلك الكثير، كل ذلك من داخل VS Code.

التكوين المتقدم

يوفر خادم MongoDB MCP العديد من خيارات التكوين المتقدمة لتخصيص سلوكه ليناسب احتياجاتك المحددة.

وضع القراءة فقط

لأمان إضافي، خاصة عند الاتصال بقواعد بيانات الإنتاج، يمكنك تشغيل الخادم في وضع القراءة فقط. سيمنع هذا أي عمليات كتابة، مثل إنشاء أو تحديث أو حذف المستندات. يمكنك تمكين وضع القراءة فقط باستخدام وسيطة سطر الأوامر:

npx mongodb-mcp-server --readOnly

أو بتعيين متغير بيئة:

export MDB_MCP_READ_ONLY=true

تعطيل أدوات محددة

يمكنك تعطيل أدوات محددة لتقييد قدرات الخادم. هذا مفيد للأمان أو لتبسيط الأوامر المتاحة. يمكنك تعطيل الأدوات باستخدام وسيطة سطر الأوامر --disabledTools، متبوعة بقائمة بأسماء الأدوات مفصولة بمسافات.

npx mongodb-mcp-server --disabledTools create update delete atlas collectionSchema

بدلاً من ذلك، يمكنك استخدام متغير البيئة MDB_MCP_DISABLED_TOOLS مع قائمة بأسماء الأدوات مفصولة بفواصل.

export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"

القياس عن بعد (Telemetry)

بشكل افتراضي، يجمع خادم MongoDB MCP بيانات استخدام مجهولة للمساعدة في تحسين المنتج. إذا كنت ترغب في تعطيل ذلك، يمكنك استخدام وسيطة سطر الأوامر --telemetry disabled أو متغير البيئة MDB_MCP_TELEMETRY=disabled.

تثبيت Docker

بالنسبة لأولئك الذين يفضلون بيئة حاويات (containerized)، يمكن تشغيل خادم MongoDB MCP في حاوية Docker. يوفر هذا عزلاً ويزيل الحاجة إلى تثبيت Node.js محلياً.

لتشغيل الخادم بسلسلة اتصال:

docker run --rm -i -e MDB_MCP_CONNECTION_STRING="your-mongodb-connection-string" mongodb/mongodb-mcp-server:latest

للتشغيل ببيانات اعتماد Atlas API:

docker run --rm -i -e MDB_MCP_API_CLIENT_ID="your-atlas-api-client-id" -e MDB_MCP_API_CLIENT_SECRET="your-atlas-api-client-secret" mongodb/mongodb-mcp-server:latest

بعد ذلك، ستقوم بتكوين عميل MCP الخاص بك لاستخدام الأمر docker بدلاً من npx. على سبيل المثال، في Claude Desktop:JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_API_CLIENT_ID=your-atlas-api-client-id",
        "-e",
        "MDB_MCP_API_CLIENT_SECRET=your-atlas-api-client-secret",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

الخلاصة

يمثل خادم MongoDB MCP خطوة مهمة إلى الأمام في دمج الذكاء الاصطناعي وقواعد البيانات. من خلال توفير طريقة موحدة لعملاء الذكاء الاصطناعي للتفاعل مع MongoDB، فإنه يفتح عالماً من الإمكانيات للمطورين. من الاستعلام باللغة الطبيعية واستكشاف البيانات إلى إدارة قواعد البيانات بمساعدة الذكاء الاصطناعي وتوليد التعليمات البرمجية، من المتوقع أن يصبح خادم MCP أداة أساسية في مجموعة أدوات المطور الحديث.

قدم هذا البرنامج التعليمي دليلاً شاملاً للبدء باستخدام خادم MongoDB MCP. باتباع هذه الخطوات، يمكنك بسهولة وسرعة ربط تطبيقات MongoDB الخاصة بك بأدوات الذكاء الاصطناعي المفضلة لديك والبدء في جني فوائد التطوير المدعوم بالذكاء الاصطناعي. نظراً لأن هذه تقنية جديدة ومتطورة، تأكد من مراجعة وثائق MongoDB الرسمية ومستودع GitHub للحصول على آخر التحديثات والميزات. مستقبل التفاعل مع قواعد البيانات هنا، ومع خادم MongoDB MCP، أنت في الطليعة.