كيفية استخدام خادم PostgreSQL MCP مع المؤشر أو كلود

@apidog

@apidog

25 نوفمبر 2025

كيفية استخدام خادم PostgreSQL MCP مع المؤشر أو كلود

Apidog للمؤسسات

نشر محلي

SSO & RBAC

متوافق مع SOC 2

استكشاف Apidog Enterprise

هل أنت من معجبي PostgreSQL وتحب فكرة وجود مساعد ذكي يدير قاعدة بياناتك كالمحترفين؟ إذاً، لديك مفاجأة. اليوم، سنغوص في خادم PostgreSQL MCP، أداة رائعة تربط قاعدة بيانات PostgreSQL الخاصة بك بعالم بروتوكول السياق النموذجي (MCP). تخيل وجود مساعد يقوم بتحليل وتصحيح ومهاجرة بياناتك - كل ذلك بينما تسترخي وتستمتع بفنجان قهوة. يبدو رائعاً؟ دعنا نستكشف هذه الجوهرة، ونضبطها، ونرى ماذا يمكن أن تقدمه لك!

💡
قبل أن نبدأ في خادم PostgreSQL MCP، دعنا نعطي تحية سريعة لـ Apidog - جوهرة حقيقية لعشاق واجهات البرمجة! تجعل هذه الأداة الأنيقة تصميم واختبار وتوثيق واجهات البرمجة أمراً سهلاً، مع واجهة مستخدم سهلة حتى يمكن للمبتدئين masteringها. إذا كنت تبني تطبيقات بجانب مغامرات قاعدة البيانات الخاصة بك، فإنها تستحق التجربة - تحقق منها على apidog.com ورأى لماذا هي أفضل صديق للمطورين!
زر
Apidog all in one image

ما هو خادم PostgreSQL MCP؟ لمحة سريعة

ماذا عن خادم PostgreSQL MCP؟ تخيله كجسر بين قاعدة بيانات PostgreSQL الخاصة بك وأدوات مدعومة بالذكاء الاصطناعي - مثل Claude Desktop أو وضع الوكيل في VS Code. يستخدم هذا المشروع مفتوح المصدر بروتوكول السياق النموذجي (MCP) لتمكين الوكلاء الذكائيين من التفاعل مع قاعدة بياناتك. ليس الأمر مجرد تشغيل استعلامات؛ بل هو مجموعة كاملة للإدارة تعالج كل شيء من ضبط الأداء إلى تعديلات المخطط ومهاجرة البيانات. تم إصداره بموجب ترخيص AGPLv3، وهو مجاني للاستخدام والتعديل، مما يجعله ملعباً للمطورين الذين يحبون PostgreSQL ودمج الذكاء الاصطناعي.

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

لماذا ستحب خادم PostgreSQL MCP

قبل أن نتعمق في التفاصيل، دعنا نتحدث عن سبب كون خادم PostgreSQL MCP يستحق وقتك:

إذا كنت تدير PostgreSQL في تطبيق مزدحم أو تريد فقط الاستمتاع بالذكاء الاصطناعي، فإن هذه الأداة ستكون نقطة تحول. دعنا نقوم بإعدادها ونراها وهي تعمل!

إعداد خادم PostgreSQL MCP: دليل خطوة بخطوة

حسناً، حان الوقت لنجعل أيدينا متسخة! إعداد خادم PostgreSQL MCP بسيط إذا كنت تعرف الأساسيات. إليك كيفية تثبيته، مباشرة من وثائق GitHub، مع لمسة حوارية.

تنزيل PostgreSQL

الخطوة 1: تحقق من المعدات الخاصة بك

أولاً، دعنا نتأكد من أن لديك الأشياء الصحيحة:

هل لديك كل ذلك؟ رائع - دعنا ننتقل!

الخطوة 2: استنساخ المستودع

انتقل إلى GitHub وحصل على كود خادم PostgreSQL MCP:

خادم PostgreSQL MCP
  1. افتح محطة الأوامر الخاصة بك (أو Git Bash على ويندوز).
  2. قم بتنفيذ:
git clone https://github.com/HenkDz/postgresql-mcp-server.git

3. ادخل إلى المجلد:

cd postgresql-mcp-server

لقد قمت بالتو لتحميل رفيق قاعدة بياناتك!

هيكل ملفات المشروع

الخطوة 3: تثبيت التبعيات

بعد ذلك، دعنا نحصل على الأدوات التي يحتاجها:

  1. في المحطة، اكتب:
npm install

2. انتظر لحظة بينما يقوم Node.js بجمع جميع المكونات الجيدة (TypeScript وغيرها من المكتبات).

تعتبر هذه الخطوة مثل ملء صندوق الأدوات الخاص بك - ضرورية للعبة التي في متناول اليد.

الخطوة 4: بناء الخادم

الآن، دعنا نحول ذلك الكود إلى شيء قابل للتشغيل:

  1. قم بتنفيذ:
npm run build

2. يقوم هذا بتجميع TypeScript إلى JavaScript في مجلد build. اعتبرها كخبز كعكة - مكونات خام داخلة، وخادم جاهز للخروج!

الخطوة 5: ضبطه لـ MCP

هنا، نقوم بتوصيل خادم PostgreSQL MCP إلى نظام MCP الخاص بك (مثل Claude Desktop أو Cursor):

  1. افتح ملف إعداد MCP الخاص بك (مثل claude_desktop_config.json أو .cursor/mcp.json).

2. أضف هذا المقتطف:

{
  "mcpServers": {
    "postgresql-mcp": {
      "command": "node",
      "args": ["/path/to/postgresql-mcp-server/build/index.js"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

3. استبدل /path/to/postgresql-mcp-server بالمسار الفعلي لمستودعك المستنسخ (مثل /home/user/postgresql-mcp-server على لينوكس).

ملف mcp.json

هذا يخبر أداة الذكاء الاصطناعي الخاصة بك، "مرحباً، إليك خادم للدردشة مع قاعدة بياناتي!"

الخطوة 6: قم بتشغيله

اختبره:

  1. قم بتنفيذ:
npm run dev

2. هذا يبدأ الخادم مع إعادة تحميل ساخن - مثالي لإجراء تعديلات أثناء العمل.

إذا كان كل شيء على ما يرام، فإن خادم PostgreSQL MCP يعمل وجاهز للتشغيل!

خادم MCP

كيفية استخدام خادم PostgreSQL MCP: سحر العالم الحقيقي

الآن بعد أن أصبح يعمل، دعنا نلعب مع بعض الميزات. يحتوي خادم PostgreSQL MCP على الكثير من الأدوات - إليك لمحة عما يمكنك القيام به.

تحليل قاعدة بياناتك

هل ترغب في إلقاء نظرة تحت غطاء PostgreSQL؟ جرب وظيفة analyze_database:

{
  "connectionString": "postgresql://user:password@localhost:5432/mydb",
  "analysisType": "performance"
}

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

خادم MCP يعمل

إعداد مثيل جديد

جديد على PostgreSQL؟ احصل على مساعدة الإعداد مع get_setup_instructions:

{
  "platform": "linux",
  "version": "15",
  "useCase": "production"
}

ستحصل على دليل خطوة بخطوة مصمم ليناسب نظام التشغيل الخاص بك واحتياجاتك. اعتبرها كمدرس ودود يأخذك عبر عملية التثبيت.

تصحيح قاعدة بيانات بطيئة

هل لديك تأخير؟ استخدم debug_database:

{
  "connectionString": "postgresql://user:password@localhost:5432/mydb",
  "issue": "performance",
  "logLevel": "debug"
}

سيقوم بالتحقق من نقاط الاختناق - ربما يكون فهرس ردئ أو تعارض في القفل - ويقترح إصلاحات. ستشكرك قاعدة بياناتك!

تصحيح خادم MCP

إدارة المخططات

هل تحتاج إلى جدول جديد؟ جرب create_table:

{
  "connectionString": "postgresql://user:password@localhost:5432/mydb",
  "tableName": "users",
  "columns": [
    { "name": "id", "type": "SERIAL", "nullable": false },
    { "name": "name", "type": "VARCHAR(100)", "nullable": false }
  ]
}

بوم - جدول users الجديد! يمكنك أيضاً تعديل الجداول الموجودة باستخدام alter_table - إضافة أعمدة، حذفها، أي شيء تحتاجه.

نقل البيانات

هل تقوم بترحيل البيانات؟ استخدم export_table_data:

{
  "connectionString": "postgresql://user:password@localhost:5432/mydb",
  "tableName": "users",
  "outputPath": "./users.json",
  "format": "json"
}

هذا يقوم بترحيل جدولك إلى ملف - رائع للنسخ الاحتياطي أو المشاركة. يمكنك استعادته باستخدام import_table_data لتحميل البيانات مرة أخرى.

نصائح الأمان لخادم PostgreSQL MCP

يأخذ خادم PostgreSQL MCP الأمان على محمل الجد، ولكن لديك دور تلعبه:

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

لماذا يتميز خادم PostgreSQL MCP في عام 2025

خادم PostgreSQL MCP بدلاً من أدوات أخرى؟ إنه ليس مجرد مدير قاعدة بيانات آخر - إنه جاهز للذكاء الاصطناعي. تسمى المشاركات على X بأنه "مغير قواعد اللعبة لمطوري Postgres"، وذلك بفضل تكامله العميق مع أنظمة MCP. على عكس العملاء الأساسيين مثل pgAdmin، تم بناؤه لأتمتة والتوسع - مثالي لوكلاء الذكاء الاصطناعي في VS Code أو Claude. بالإضافة إلى ذلك، إنه مفتوح المصدر، لذا يمكنك تعديله ليتناسب مع أفكارك الأكثر جنوناً.

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

زر

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات