pg-aiguide MCP — حالات الاستخدام, التثبيت & عرض مباشر

Name: pg-aiguide MCP Server
Author: timescale

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

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

بحث موحد عبر مستندات PostgreSQL و TimescaleDB و PostGIS
يدعم الإصدارات — النتائج مرتبطة بإصدار PG الذي تسأل عنه
مهارات مختارة بعناية حول تصميم المخطط والفهرسة والميزات الحديثة في PG
نقطة نهاية MCP مستضافة على https://mcp.tigerdata.com/docs
قابل للتثبيت أيضاً كمكوّن إضافي لـ Claude

عرض مباشر

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

pg-aiguide.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pg-aiguide": {
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "pg-aiguide",
      "command": "uvx",
      "args": [
        "pg-aiguide"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "pg-aiguide": {
      "command": {
        "path": "uvx",
        "args": [
          "pg-aiguide"
        ]
      }
    }
  }
}

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

claude mcp add pg-aiguide -- uvx pg-aiguide

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

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

استخدامات عملية: pg-aiguide

كيفية الحصول على وكيل لكتابة مخطط Postgres بجودة الإنتاج

👤 مهندسو الواجهة الخلفية الذين يبدأون خدمة جديدة ⏱ ~20 min intermediate

متى تستخدمه: تريد SQL مولد يتحمل فعلاً مراجعة الرمز.

المتطلبات الأساسية

أضف pg-aiguide MCP — وجّه العميل إلى https://mcp.tigerdata.com/docs أو ثبّت مكوّن Claude الإضافي

الخطوات

حدد المجال

أحتاج إلى مخطط لـ SaaS متعدد المستأجرين مع المؤسسات والمستخدمين والمشاريع والدعوات. قبل كتابة SQL، استشر pg-aiguide للحصول على أفضل الممارسات في تصميم المخطط والمعرّفات.✓ تم النسخ

→ يستشهد الوكيل بمخرجات view_skill
راجع القيود والفهارس

أظهر لي كل قيد أضفته ولماذا. هل هناك فهارس زائدة؟✓ تم النسخ

→ تبرير لكل فهرس
تحقق من الميزات الحديثة

استخدم search_docs للتحقق من أنك تستخدم GENERATED ALWAYS AS IDENTITY (وليس SERIAL)، و NULLS NOT DISTINCT حيث ينطبق ذلك.✓ تم النسخ

→ تطبيق أسلوب حديث

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

المزالق

الوكيل يسيء استخدام الفهارس — الجداول الثقيلة في الكتابة تبطأ — اطلب فهرسة محسوبة بناءً على الحمل — أخبره بنسبة القراءات/الكتابات المتوقعة

اجمعها مع: postgres

كيفية الحصول على سياق خبير عند قراءة خطة EXPLAIN

👤 المطورون الذين يحسنون الاستعلام البطيء ⏱ ~15 min intermediate

متى تستخدمه: لديك مخرجات EXPLAIN ANALYZE ولا تعرف ما هو طبيعي.

الخطوات

شارك الخطة

[الصق EXPLAIN ANALYZE] — استخدم pg-aiguide لتحديد وظيفة كل عقدة والأسباب النموذجية للتكلفة هنا.✓ تم النسخ

→ تشخيص عقدة تلو الأخرى مع الاستشهاد بالمستندات
اطلب نصيحة الفهرس

بناءً على الخطة، اقترح تغييراً واحداً في الفهرس. تحقق من نوع الفهرس (BTREE مقابل BRIN مقابل جزئي) عبر pg-aiguide.✓ تم النسخ

→ CREATE INDEX ملموس مع تبرير

النتيجة: الخطة مفهومة، التغيير مدافع عنه بالمستندات.

اجمعها مع: postgres

كيفية اختيار إعدادات hypertable الصحيحة في TimescaleDB

👤 الفرق التي تقوم بعمل سلاسل زمنية على Postgres ⏱ ~15 min advanced

متى تستخدمه: أول hypertable في خدمة جديدة — العديد من المقابض.

الخطوات

حدد شكل البيانات الداخلة

سأدخل ~10k صف/ثانية من بيانات مستشعرات إنترنت الأشياء، الاستعلامات هي تجميعات آخر 24 ساعة وآخر 30 يوماً. استشر pg-aiguide للحصول على توصيات فترة الكتل في TimescaleDB.✓ تم النسخ

→ فترة الكتلة + منطق سياسة الضغط
صيغ الجدول

صيغ CREATE TABLE + create_hypertable + سياسة الضغط.✓ تم النسخ

→ DDL كامل

النتيجة: تكوين Hypertable معاير لمعدل إدخال البيانات الخاص بك.

اجمعها مع: postgres

التركيبات

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

pg-aiguide + postgres

استشر pg-aiguide للحصول على أفضل الممارسات، ثم طبّقها فعلاً عبر postgres MCP

استخدم pg-aiguide لاختيار الفهرس الصحيح لـ orders.user_id، ثم طبّقه عبر postgres MCP على قاعدة البيانات الإنمائية. أظهر EXPLAIN ANALYZE قبل/بعد.✓ تم النسخ

pg-aiguide + github

مراجعة الرمز لهجرة المخطط بمنطق مدعوم بالمستندات

راجع PR #4421 الذي يضيف جدول جديد. استخدم pg-aiguide للإشارة إلى أي اختيارات تنحرف عن أسلوب PG 16 الصحيح.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
search_docs	query: str, product?: 'postgres'\|'timescale'\|'postgis', version?: str	ابحث عن ميزة أو دالة أو إعداد معين	free
view_skill	skill: 'schema-design'\|'indexing'\|'data-types'\|'performance'	طبّق إرشادات أفضل الممارسات قبل كتابة المخطط	free

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

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

حصة API: نقطة نهاية مستضافة — حدود معدل الاستخدام المعقول
الرموز لكل استدعاء: 300-1500 رمز لكل نتيجة بحث
التكلفة المالية: مجاني
نصيحة: استخدم view_skill للإرشادات العامة، و search_docs فقط عندما تحتاج إلى استشهاد محدد.

الأمان

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

الحد الأدنى من الصلاحيات: لا شيء — المستندات فقط

تخزين بيانات الاعتماد: لا شيء

نقل البيانات الخارجي: تذهب استعلاماتك إلى mcp.tigerdata.com

لا تمنح أبدًا: لا شيء يمنح؛ لا توجد إمكانية الوصول إلى قاعدة البيانات

هذا MCP لا ينفذ SQL — اقترنه مع postgres MCP عندما تحتاج إلى تشغيل الاستعلامات.

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

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

search_docs يرجع معلومات قديمة

حدد الإصدار: search_docs(query, version='17') لتفاصيل PG 17 المحددة.

فشل الاتصال بـ mcp.tigerdata.com

تحقق من جدار الحماية الشركة؛ عد إلى تثبيت مكوّن Claude الإضافي (محلي).

تحقق: curl -I https://mcp.tigerdata.com/docs

view_skill يرجع مخرجات عامة

حدد اسم المهارة بدقة — الأسماء المجهولة تعود إلى الملخصات العامة.

البدائل

pg-aiguide مقابل البدائل

البديل	متى تستخدمها	المقايضة
postgres MCP	تحتاج إلى تنفيذ SQL، وليس فقط قراءة المستندات	لا توجد طبقة أفضل الممارسات المختارة بعناية
Supabase MCP	إدارة المشروع الخاصة بـ Supabase	مقيد بـ Supabase

pg-aiguide

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

استخدامات عملية: pg-aiguide

كيفية الحصول على وكيل لكتابة مخطط Postgres بجودة الإنتاج

المتطلبات الأساسية

الخطوات

المزالق

كيفية الحصول على سياق خبير عند قراءة خطة EXPLAIN

الخطوات

كيفية اختيار إعدادات hypertable الصحيحة في TimescaleDB

الخطوات

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

pg-aiguide مقابل البدائل

المزيد

الموارد