/ الدليل / الملعب / db-mcp-server
← كل الخوادم ↗ GitHub
● مجتمع FreePeak ⚡ فوري

db-mcp-server

بواسطة FreePeak · FreePeak/db-mcp-server

خادم MCP واحد، عدة قواعس بيانات — MySQL و Postgres و SQLite و Oracle و TimescaleDB. كل اتصال يحصل على مجموعة أدواته الخاصة للاستعلام والمخطط والأداء.

db-mcp-server (FreePeak) يتصل بعدة قواعد بيانات في نفس الوقت. لكل اتصال مُعدَّل، يقوم بتوليد أدوات للاستعلام والتنفيذ والمعاملات والمخطط والأداء تلقائياً. يدعم TimescaleDB (الجداول الزمنية الفائقة والتجميعات المستمرة) وميزات Oracle المتخصصة (RAC والمحفظة).

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

db.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "db": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/FreePeak/db-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "db": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/FreePeak/db-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "db": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/FreePeak/db-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "db": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/FreePeak/db-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "db",
      "command": "TODO",
      "args": [
        "See README: https://github.com/FreePeak/db-mcp-server"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "db": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/FreePeak/db-mcp-server"
        ]
      }
    }
  }
}

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

claude mcp add db -- TODO 'See README: https://github.com/FreePeak/db-mcp-server'

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

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

استخدامات عملية: db-mcp-server

تشغيل تحليل متعدد قواعد البيانات من Claude

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

متى تستخدمه: عندما تحتاج للسحب من Postgres (التطبيق) و MySQL (القديم) في محادثة واحدة دون تبديل الأدوات.

المتطلبات الأساسية
  • ملف config.json يحتوي على كلا الاتصالين — توثيق الريبو يوضح الشكل؛ خزّن بيانات الاعتماد في متغيرات البيئة، وليس مباشرة
الخطوات
  1. ابدأ الخادم
    شغّل ./bin/server -t sse -c config.json وتأكد من رفع كلا الاتصالين.✓ تم النسخ
    → سجلات الخادم تظهر اتصالين بحالة جيدة
  2. استعلم عن كل واحدة
    من prod (Postgres): المستخدمون الذين تسجلوا الأسبوع الماضي. من legacy (MySQL): الطلبات المنسوبة لهم. دمج في الذاكرة.✓ تم النسخ
    → مجموعة بيانات مدمجة

النتيجة: رؤى عابرة الأنظمة دون مستودع بيانات.

المزالق
  • افتراض القراءة فقط ينكسر — الوكيل ينفذ عمليات INSERT — استخدم مستخدمي قراءة فقط على مستوى قاعدة البيانات لكل اتصال؛ لا تعتمد على انضباط الوكيل
اجمعها مع: google-sheets

إدارة جداول TimescaleDB الفائقة من Claude

👤 فرق المراقبة / إنترنت الأشياء ⏱ ~20 min advanced

متى تستخدمه: عندما تريد إنشاء/فحص الجداول الفائقة والتجميعات المستمرة دون حفظ Timescale DDL.

الخطوات
  1. فحص الجداول الفائقة الموجودة
    اسرد جميع الجداول الفائقة في قاعدة البيانات metrics مع فترة القطع وعدد الصفوف.✓ تم النسخ
    → جدول الجداول الفائقة
  2. إنشاء تجميع مستمر
    أنشئ تجميع كل ساعة على sensor_readings مجمّع حسب device_id بـ avg و max و min.✓ تم النسخ
    → تم إنشاء CAgg؛ تم تكوين سياسة التحديث

النتيجة: عمليات Timescale في دقائق، وليس عمليات بحث Google.

شرح مخطط غير مألوف للتوظيف السريع

👤 المهندسون الذين يرثون قاعدة بيانات ⏱ ~30 min beginner

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

الخطوات
  1. تفريغ المخطط
    استخدم schema_<conn_id> على prod. أرجع الجداول وخريطة FK وترتيب عدد الصفوف.✓ تم النسخ
    → المخطط + خريطة FK
  2. إنشاء قاموس
    لكل جدول، استنتج وصفاً من سطر واحد من أسماء الأعمدة والصفوف النموذجية (حد أقصى 5 لكل جدول).✓ تم النسخ
    → ورقة غش التوظيف

النتيجة: نموذج عقلي عملي في 30 دقيقة.

التركيبات

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

db + google-sheets

تصدير نتيجة استعلام إلى ورقة مشتركة للجهات المعنية غير التقنية

استعلم عن أفضل 50 عميل حسب LTV من prod؛ اكتب إلى ورقة 'Top LTV'.✓ تم النسخ
db + prometheus

التحقق المتبادل من نتائج الاستعلامات البطيئة في قاعدة البيانات مع مقاييس Prometheus على مستوى قاعدة البيانات

للاستعلام البطيء الموجود عبر performance_prod، اعرض مقاييس pg_stat_statements من Prometheus للنافذة الزمنية نفسها.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
query_<db_id> sql: str (SELECT) قراءة البيانات 1 query
execute_<db_id> sql: str (DDL/DML) العمليات — محمية بأذونات قاعدة البيانات 1 query
transaction_<db_id> statements: str[] تغييرات ذرية متعددة العبارات 1 tx
schema_<db_id> table?: str الاكتشاف / التوظيف metadata query
generate_schema_<db_id> format: sql|json التصدير للتوثيق/التحكم بالإصدار metadata queries
performance_<db_id> sql?: str ضبط استعلام بطيء plan + stats

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

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

حصة API
سعة قواعد بيانات
الرموز لكل استدعاء
مجموعات النتائج الكبيرة تحرق الرموز بسرعة — استخدم LIMIT بقوة
التكلفة المالية
MCP مجاني؛ تكاليف استضافة قاعدة البيانات من حسابك
نصيحة
أضف دائماً LIMIT / قيّد الإخراج؛ اجعل البيانات تتدفق إلى ملف عبر MCP نظام الملفات للسحب الأكبر

الأمان

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

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

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

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

Connection pool exhausted

ضبط حجم المجموعة في config.json؛ اقتل جلسات الزومبي من جانب قاعدة البيانات؛ تحقق من عدم وجود حلقات وكيل تاهبة

تحقق: SELECT * FROM pg_stat_activity (لـ Postgres)
Oracle wallet auth fails

يجب أن يكون مسار TNS_ADMIN قابلاً للقراءة من قبل عملية MCP؛ على mac/linux راقب SELinux/AppArmor

Tool names don't appear for one DB

من المحتمل أن الاتصال فشل في التهيئة؛ تحقق من سجلات الخادم — عادة بيانات اعتماد خاطئة أو جدار ناري

البدائل

db-mcp-server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
postgres-mcp (رسمي)تحتاج فقط إلى Postgresقاعدة بيانات واحدة
mysql-mcp (مجتمع)تحتاج فقط إلى MySQLقاعدة بيانات واحدة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills