# postgresql mcp

Postgres MCP Pro هو خادم Model Context Protocol (MCP) قوي لـ PostgreSQL، يوفر وصولاً قابلاً للتكوين للقراءة/الكتابة، وتحليل أداء متقدم، وضبط الفهارس، وخطط التفسير، وتنفيذ SQL آمن لوكلاء الذكاء الاصطناعي.

Canonical URL: https://a2a-mcp.org/entry/postgresql-mcp-ar

Language: ar

Category: MCP Servers

Updated: 2026-04-06

## نظرة عامة

**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 (مُوصى به)
اسحب وشغّل الصورة الرسمية:
```bash
docker run -p 8080:8080 crystaldba/postgres-mcp --connection-string "postgresql://user:pass@localhost:5432/mydb"
```

### التثبيت عبر Python / uv
```bash
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](https://github.com/crystaldba/postgres-mcp)
- التنفيذات الأخرى البارزة: pgEdge Postgres MCP، AWS Labs Aurora MCP، التفرعات المجتمعية المختلفة.
- بروتوكول سياق النموذج (Model Context Protocol): مواصفات MCP الرسمية.

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

## Tags

- mcp
- postgresql
- postgres
- mcp-server
- sql
- قاعدة بيانات
- وكيل ذكاء اصطناعي
- ضبط الفهارس
- تحليل الأداء
- claude
- cursor

## Sources

- [Project website](https://github.com/crystaldba/postgres-mcp)