إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يمكن لإضافة PostgreSQL تسجيل تعريف خادم بروتوكول سياق النموذج (MCP) في المضيفين المدعومين بالذكاء الاصطناعي. يتيح هذا التسجيل للمضيف اكتشاف أدوات PostgreSQL لإدارة الاتصالات، واستكشاف المخططات، وتنفيذ الاستعلامات، وسير العمل المرتبط دون الحاجة إلى تكوين كل أداة يدويا.
استخدم هذه الصفحة عندما تريد فهم كيفية عمل دعم MCP في الإضافة، وما هي المضيفات المدعومة اليوم، وأي عائلات الأدوات تصبح متاحة بعد التسجيل.
المتطلبات الأساسية
قبل أن تعتمد على خادم MCP، تأكد من أنك تملك:
- إضافة PostgreSQL مثبتة في تعليمة Visual Studio برمجية أو Cursor.
- ميزات Copilot/AI مفعلة في الامتداد (
pgsql.copilot.enableهوtrue). يحافظ معرف الإعداد على بادئتهpgsql.copilot.*في كلا المحررين؛ ويظهر التسمية كAI في المؤشر. - على الأقل ملف تعريف اتصال محفوظ واحد إذا كنت تريد أدوات MCP للاتصال بخادم بسرعة.
- مضيف مدعوم يعرض واجهة برمجة تطبيقات تسجيل MCP.
افهم كيف يعمل تسجيل MCP
يقوم الامتداد بتسجيل خادم MCP تلقائيا عندما تكون كل ما يلي صحيحا:
- يعرض المضيف واجهة برمجة تطبيقات تسجيل MCP مدعومة.
- يمكن للإضافة استرجاع رابط خادم MCP ورمز حامل صالحين من خدمة اللغة الخاصة بها.
- تم تفعيل دمج Copilot.
اليوم، يدعم مسار الكود بشكل صريح:
- تعليمة Visual Studio برمجية 1.102 وما بعده من خلال واجهة برمجة تطبيقات مزود تعريف الخادم MCP
-
المؤشر عبر واجهة برمجة تطبيقات MCP الخاصة بالمؤشر
registerServer
في تعليمة Visual Studio برمجية، يقوم الامتداد بتسجيل الخادم ك PostgreSQL MCP. في Cursor، يسجل الخادم ك pgsql-mcp.
مهم
الإضافة لا تعرض حاليا تدفق إعداد يدوي للنسخ واللصق للعملاء المستقلين الذين يتوقعون منك إدخال عنوان MCP ورمز الرمز بنفسك. إذا لم يدعم عميلك الاكتشاف أو التسجيل على مستوى المضيف، استخدم سير عمل الذكاء الاصطناعي المدمج في الإضافة بدلا من ذلك.
تحضير ملفات تعريف الاتصال لأدوات MCP
تعتمد معظم تدفقات MCP المفيدة على معلومات الاتصال المحفوظة.
- افتح الاتصالات وحدد الهوية وأنشئ أو حدث ملفات تعريف الاتصال التي تريد من المضيف استخدامها.
- احفظ بيانات الاعتماد حيث يتطلب سير عملك ذلك.
- تحقق من قدرتك على الاتصال بقاعدة البيانات المستهدفة من الإضافة قبل الاعتماد على الأتمتة المعتمدة على MCP.
وهذا مهم لأن أدوات MCP الموجهة للاتصال تحدد ملف التعريف المستهدف من مخزن اتصال الامتداد بدلا من تكوين قاعدة بيانات منفصل في مضيف الذكاء الاصطناعي.
استخدم أدوات MCP في مضيف مدعوم
بعد اكتشاف المضيف لخادم PostgreSQL MCP، يمكنه استدعاء سطح الأداة المكشوف بواسطة الامتداد.
| عائلة الأدوات | ما الذي يساعده ذلك | الاستخدام النموذجي |
|---|---|---|
| ملفات تعريف الاتصال بالقائمة | اكتشف الملفات الشخصية المحفوظة | ابحث عن الملف الشخصي المناسب قبل الاتصال |
| الاتصال بقاعدة بيانات PostgreSQL | فتح جلسة قاعدة بيانات من ملف ملف حفظ | ابدأ مهمة على الخادم أو قاعدة البيانات الصحيحة |
| قواعد بيانات القوائم | تعداد قواعد البيانات على الخادم المتصل | تبديل السياق أو فحص قواعد البيانات المتاحة |
| الحصول على كائنات قاعدة البيانات | سياق المخطط الخاص بجلب | حدد الجداول، والمشاهد، والوظائف، والكائنات الأخرى قبل طرح الأسئلة التالية |
| إجراء استعلام | تنفيذ SQL موجه للقراءة | فحص البيانات أو التحقق من صحة الافتراضات |
| تعديل قاعدة البيانات | تنفيذ تغييرات البيانات أو المخطط | تطبيق DDL أو DML في سير العمل الذي يتطلب الوصول إلى الكتابة |
| Open SQL Script | أنشئ نصا للمراجعة | الانتقال من مخرجات الوكيل إلى تدفق محرر الاستعلامات المراجعة البشرية |
| خطة الاستعلام | فحص بيانات الخطط المخزنة مؤقتا | تحليل سير العمل الوظيفي |
| تخطيط قاعدة البيانات Visualize | عرض عرض مخطط | افهم العلاقات قبل كتابة أو تغيير SQL |
| احصل على سياق لوحة المعلومات | استرجاع سياق جلسة لوحة التحكم النشطة، بما في ذلك المقاييس والإعدادات المتاحة | اكتشف المقاييس المتاحة قبل طلب بيانات المقياس |
| احصل على بيانات مقياس لوحة المعلومات | جمع بيانات السلاسل الزمنية المخزنة مؤقتا دفعة من لوحة تحكم خادم مفتوح | تحليل اتجاهات أداء الخوادم دون تشغيل استعلامات مباشرة |
نصيحة
لسير عمل أكثر أمانا، ابدأ بأدوات الاكتشاف مثل ملفات تعريف الاتصال بالقائمة، الاتصال بقاعدة بيانات PostgreSQL، والحصول على كائنات قاعدة البيانات قبل تشغيل الاستعلامات أو التعديلات.
اختر بين MCP وتجارب الذكاء الاصطناعي المدمجة
استخدم خادم MCP عندما يدعم مضيفك اكتشاف MCP وتريد أن يعرض الامتداد سطح أداة PostgreSQL الخاص به هناك.
استخدم تجارب الامتداد المدمجة عندما:
- تريد الدردشة مباشرة مع مشارك @pgsql في الدردشة (تعليمة Visual Studio برمجية فقط)،
- تريد أتمتة متعددة الخطوات داخل وضع الوكيل (تعليمة Visual Studio برمجية وCursor)، أو
- مضيفك الحالي لا يظهر تسجيل MCP الخاص بالامتداد تلقائيا.
استكشاف الأخطاء وتوفر MCP
المضيف لا يعرض خادم PostgreSQL MCP
تأكد من أنك تستخدم مضيفا مدعوما وأن تكامل Copilot/AI مفعل في الإضافة. إذا لزم الأمر، أعد تحميل النافذة بعد تسجيل الدخول أو غير إعدادات Copilot/AI.
يتم تخطي التسجيل
يتخطى الامتداد التسجيل عندما لا يستطيع استرجاع رابط أو رمز MCP قابل للاستخدام من خدمة اللغة. تحقق من سجلات إخراج الإضافة إذا لم يكتشف المضيف الخادم بعد إعادة التحميل.
لا يمكن لأداة الاتصال بقاعدة بياناتي
تحقق من وجود ملف تعريف الاتصال المستهدف وأن الامتداد يمكنه استخدامه مباشرة. تعتمد تدفقات MCP على نفس مخزن الاتصال ودقة بيانات الاعتماد كما في بقية الامتداد.
أحتاج إلى نقطة نهاية يدوية لعميل MCP آخر
لا يوفر الامتداد حاليا سير عمل يدوي لنقطة النهاية للمستخدمين لعملاء MCP المستقلين. استخدم مضيفا مدعوما أو عد إلى تجارب الذكاء الاصطناعي المدمجة الموثقة في هذه الوثائق.