MongoDB MCP Server

Name: MongoDB MCP Server MCP Server
Author: kiliczsh

لماذا تستخدمه

الميزات الأساسية

تمرير سلسلة الاتصال كمعامل CLI — لا حاجة لملف .env
وضع القراءة فقط يُعطّل جميع العمليات المعدِّلة
استنتاج المخطط من المستندات المُعيَّنة
دعم aggregation pipeline
فحص الفهارس لمحادثات ضبط الاستعلامات

عرض مباشر

كيف يبدو في الممارسة

mongo-mcp-kiliczsh.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mongo-mcp-kiliczsh",
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "mongo-mcp-kiliczsh": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-mongo-server",
          "mongodb://localhost:27017/mydb"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add mongo-mcp-kiliczsh -- npx -y mcp-mongo-server mongodb://localhost:27017/mydb

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: MongoDB MCP Server

استكشاف قاعدة بيانات MongoDB غير مألوفة دون كتابة أي شيء

👤 المطورون الذين يُهيّؤون أنفسهم لخدمة جديدة ⏱ ~15 min beginner

متى تستخدمه: ورثت نسخة Mongo والمخطط غير موثق.

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

مستخدم Mongo للقراءة فقط — db.createUser({user:'reader', roles:[{role:'read', db:'mydb'}]})

الخطوات

الاتصال بوضع القراءة فقط

Use the mongo MCP. List all collections and infer the schema for the top 3 by size.✓ تم النسخ

→ قائمة Collections + JSON schema لكل collection
الفحص السريع

Show me 5 sample documents from orders — anonymize emails.✓ تم النسخ

→ 5 مستندات مع إخفاء البيانات الشخصية
رسم العلاقات

Which collections reference each other by ObjectId? Draw a quick text diagram.✓ تم النسخ

→ مخطط ER نصي

النتيجة: نموذج ذهني عملي عن قاعدة البيانات في 10 دقائق، دون الحاجة لمدير قواعد بيانات.

المزالق

العيّنة تفوّت الحقول عالية الكاردينالية — زِد حجم العيّنة في استدعاء الاستنتاج؛ عيّن حسب التاريخ إذا كانت البيانات منحازة زمنيًا

اجمعها مع: filesystem

ضبط aggregation بطيء بنصيحة فهرس من Claude

👤 مطورو الواجهة الخلفية ⏱ ~25 min intermediate

متى تستخدمه: aggregation pipeline تستغرق 30 ثانية ولا تعلم أي مرحلة هي التكلفة.

الخطوات

التحليل

Run this aggregation with explain=true. Show the winning plan.✓ تم النسخ

→ مخرجات explain مع المستندات الممسوحة في كل مرحلة
التشخيص

Which stage is the bottleneck? What index would help?✓ تم النسخ

→ اقتراح فهرس محدد مع مبرراته
التحقق

Re-explain after I add the index. Did totalDocsExamined drop?✓ تم النسخ

→ نعم/لا مع الأرقام

النتيجة: aggregation أسرع 10 مرات بفهرس واحد مستهدف.

المزالق

Claude يقترح فهرسًا يُضخّم عمليات الكتابة — اسأل: 'ما عقوبة الكتابة التي يضيفها هذا الفهرس؟' قبل التطبيق

العثور على المستندات التي تنتهك مخططًا ضمنيًا

👤 مهندسو البيانات ⏱ ~20 min intermediate

متى تستخدمه: قواعد البيانات بلا مخطط تتراكم فيها الانجرافات؛ تحتاج لإيجاد المخالفين.

الخطوات

أخذ العيّنة

Sample 1000 documents from users. What fields are missing or have unexpected types?✓ تم النسخ

→ جدول قيم فارغة / تردد الأنواع لكل حقل
البحث

Find all users where email is null or not a string.✓ تم النسخ

→ العدد + عيّنة من _ids

النتيجة: تقرير بيانات غير نظيفة محدد يمكن تسليمه لسكريبتات الترحيل.

المزالق

الـ collections الكبيرة تصطدم بمهلة الاستجابة — استخدم $sample ثم حدد نطاق المتابعة بالنطاقات

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

mongo-mcp-kiliczsh + filesystem

تصدير نتائج aggregation إلى JSON للأدوات اللاحقة

Run the aggregation and save results to /tmp/orders-by-month.json.✓ تم النسخ

mongo-mcp-kiliczsh + github

فتح PR بسكريبت ترحيل بعد اكتشاف الانجراف

We found 1200 users without email. Open a PR with a backfill migration.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
find	collection, filter, projection?, limit?	البحث عن مستندات محددة	1 query
aggregate	collection, pipeline[], explain?	تجميع/تحويل البيانات	1 query
list_collections	(none)	اكتشاف محتوى قاعدة البيانات	free
schema	collection, sample_size?	استنتاج الشكل من المستندات المُعيَّنة	1 sample read
list_indexes	collection	محادثات الضبط	free
insert_one	collection, document	فقط عند عدم استخدام وضع --read-only	1 write

التكلفة والحدود

تكلفة التشغيل

حصة API: مقيّد بـ RU/IOPS كلستر Mongo الخاص بك
الرموز لكل استدعاء: 200–5000 بحسب حجم النتيجة
التكلفة المالية: مجاني (مفتوح المصدر)
نصيحة: اسقط الحقول التي تحتاجها فقط؛ ضع حدًا للـ limit مبكرًا

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: read on the target db

تخزين بيانات الاعتماد: URI يُمرَّر كمعامل CLI — احتفظ به خارج سجل الـ shell

نقل البيانات الخارجي: إلى مضيف Mongo فقط

لا تمنح أبدًا: dbAdmin root

URIs التي تحتوي كلمات مرور تنتهي في وسيطات العملية؛ بعض الأنظمة تسجّلها

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

MongoServerSelectionError

تحقق من الاتصال وقائمة السماح بـ IP وإعدادات TLS

تحقق: mongosh مع نفس URI

Authentication failed

تحقق من authSource في URI (غالبًا admin)؛ تأكد من وجود المستخدم في تلك قاعدة البيانات

Tool not found in read-only mode

احذف --read-only إذا احتجت الكتابة؛ وإلا استخدم MCP مختلفًا للكتابة

البدائل