postgresql mcp

نظرة عامة

PostgreSQL MCP (المشار إليه عادة باسم Postgres MCP Pro) هو خادم بروتوكول سياق النموذج (MCP) مفتوح المصدر مصمم لمنح وكلاء الذكاء الاصطناعي وصولاً آمناً وذكياً إلى قواعد بيانات PostgreSQL.

إنه يتجاوز بكثير تنفيذ الاستعلامات الأساسية من خلال تقديم أوضاع للقراءة فقط أو القراءة/الكتابة قابلة للتكوين، وتشخيصات شاملة للأداء، وتوصيات تلقائية بالفهارس، وميزات أمان مناسبة للإنتاج. مُبنى لدعم دورة حياة التطوير الكاملة — من استكشاف المخطط والبرمجة إلى الاختبار، والنشر، والصيانة المستمرة.

تشمل التطبيقات الشائعة الإصدار المرجعي الأصلي من Anthropic (المهمل/المؤرشف الآن لأسباب تتعلق بالأمان)، والفروع المجتمعية، والإصدارات المحسنة مثل Postgres MCP Pro بواسطة Crystal DBA.

الميزات

• أوضاع الوصول القابلة للتكوين: معاملات للقراءة فقط صارمة (تمنع التعديلات) أو قراءة/كتابة خاضعة للتحكم مع أمان المعاملات.
• استكشاف المخطط والبيانات: عرض قوائم الجداول، فحص المخططات، الأعمدة، الفهارس، القيود، وتنفيذ استعلامات مدعومة باللغة الطبيعية.
• تحليل الأداء: فحوصات صحية لـ buffer cache، حالة vacuum، تأخر التكرار replication lag، استخدام الاتصالات، حدود التسلسلات، والمزيد.
• ضبط الفهارس وخطط التوضيح Explain Plans: محرك متقدم لتوصية الفهارس يختبر آلاف التركيبات؛ دعم للفهارس الافتراضية وخطط توضيح استعلام مفصلة.
• تنفيذ SQL آمن: أغلفة للقراءة فقط، التحقق من صحة الاستعلامات، وضمانات ضد العمليات الخطرة.
• مُحسّن لوكلاء الذكاء الاصطناعي: أدوات مصممة لاستخدام منخفض للـ tokens، وتنسيق إخراج واضح، ودمج سلس مع Claude، Cursor، Gemini، وعملاء MCP آخرين.
• Docker ونشر سهل: صورة Docker رسمية لتشغيل متسق وخالٍ من التبعيات.
• قابل للتوسع: يدعم Postgres المجتمعي، وRDS، وAurora، ومعظم مثيلات PostgreSQL الإصدار 12 فما فوق.

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

• تطوير قاعدة بيانات بمساعدة الذكاء الاصطناعي: اسمح لوكيل الذكاء الاصطناعي الخاص بك باستكشاف المخططات، أو اقتراح استعلامات مثلى، أو توليد هجرات migrations بلغة طبيعية.
• ضبط الأداء: اسأل "حلل الاستعلامات البطيئة" أو "اقترح فهارس لهذا الجدول" — احصل على رؤى قابلة للتنفيذ مع خطط توضيح explain plans.
• مراقبة الإنتاج: قم بتشغيل فحوصات صحية، أو اكتشف الانتفاخ bloat، أو راقب vacuum/autovacuum بدون SQL يدوي. -l> تحليل بيانات آمن: منح صلاحية للقراءة فقط للتقارير، أو التحليلات، أو وكلاء دعم العملاء دون المخاطرة بسلامة البيانات.
• سير عمل تطوير كامل: من إعداد المشروع الأولي والاختبار إلى النشر والتحسين المستمر — كلها مدفوعة بالذكاء الاصطناعي المحادثي.

التثبيت والبدء السريع

باستخدام Docker (مُوصى به)

اسحب وشغّل الصورة الرسمية:

docker run -p 8080:8080 crystaldba/postgres-mcp --connection-string "postgresql://user:pass@localhost:5432/mydb"

التثبيت عبر Python / uv

uv pip install postgres-mcp
uv run postgres-mcp "postgresql://user:password@localhost:5432/dbname"

تكوين العملاء (Claude Desktop، Cursor، إلخ)

أضف إلى تكوين MCP الخاص بك (على سبيل المثال، ~/.cursor/mcp.json أو إعدادات Claude) باستخدام الأمر/المعطيات المناسبة للإشارة إلى الخادم قيد التشغيل.

التوثيق الكامل، أمثلة الاتصال، وأفضل ممارسات الأمان متاحة في المستودع.

ملاحظات الأمان

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

الروابط

• GitHub (Postgres MCP Pro): crystaldba/postgres-mcp
• التنفيذات الأخرى البارزة: pgEdge Postgres MCP، AWS Labs Aurora MCP، التفرعات المجتمعية المختلفة.
• بروتوكول سياق النموذج (Model Context Protocol): مواصفات MCP الرسمية.

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