pg-aiguide

pg-aiguide

AI-अनुकूलित PostgreSQL विशेषज्ञता कोडिंग सहायकों के लिए

pg-aiguide AI कोडिंग टूल्स को काफी बेहतर PostgreSQL कोड लिखने में मदद करता है। यह प्रदान करता है:

• आधिकारिक PostgreSQL मैनुअल में सिमेंटिक खोज (संस्करण-जागरूक)
• AI-अनुकूलित "स्किल्स" — चयनित, विचार-आधारित Postgres सर्वोत्तम अभ्यास जो AI एजेंटों द्वारा स्वचालित रूप से उपयोग किए जाते हैं
• एक्सटेंशन इकोसिस्टम दस्तावेज़, TimescaleDB से शुरू करते हुए, और जल्द ही और अधिक

इसे इस रूप में उपयोग करें:

• एजेंट स्किल्स npx skills के माध्यम से — Claude Code, Cursor, Codex, Gemini CLI, और 40+ अन्य एजेंटों के साथ काम करता है
• एक सार्वजनिक MCP सर्वर जिसे किसी भी AI कोडिंग एजेंट के साथ उपयोग किया जा सकता है, या
• एक Claude Code प्लगइन जो Claude के मूल स्किल समर्थन के लिए अनुकूलित है।

⭐ pg-aiguide क्यों?

AI कोडिंग टूल्स अक्सर Postgres कोड उत्पन्न करते हैं जो:

• पुराना होता है
• बाधाओं और इंडेक्स की कमी रखता है
• आधुनिक PG सुविधाओं से अनजान होता है
• वास्तविक दुनिया के सर्वोत्तम अभ्यासों के अनुरूप नहीं होता

pg-aiguide AI एजेंटों को गहरा, संस्करणित PostgreSQL ज्ञान और सिद्ध पैटर्न देकर इसे ठीक करता है।

अंतर देखें

https://github.com/user-attachments/assets/5a426381-09b5-4635-9050-f55422253a3d

🚀 त्वरित आरंभ

एजेंट स्किल्स

अपने AI कोडिंग एजेंट के लिए चयनित PostgreSQL सर्वोत्तम-अभ्यास स्किल्स स्थापित करें:

npx skills add timescale/pg-aiguide --skill postgres

या मौजूदा PostgreSQL डेटाबेस की जांच करने के लिए स्कीमा अन्वेषण स्किल स्थापित करें:

npx skills add timescale/pg-aiguide --skill schema-exploration

या व्यक्तिगत स्किल्स को इंटरैक्टिव रूप से चुनें:

npx skills add timescale/pg-aiguide

Claude Code, Cursor, Codex, Gemini CLI, VS Code, और 40+ अन्य एजेंटों के साथ काम करता है।

और गहरे PostgreSQL ज्ञान के लिए, आधिकारिक PostgreSQL, TimescaleDB, और PostGIS मैनुअल पर सिमेंटिक खोज देने के लिए MCP सर्वर भी जोड़ें।

MCP सर्वर

PostgreSQL, TimescaleDB, और PostGIS दस्तावेज़ों पर सिमेंटिक खोज के लिए, सार्वजनिक MCP सर्वर जोड़ें:

https://mcp.tigerdata.com/docs

{
  "mcpServers": {
    "pg-aiguide": {
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

या इसे Claude Code प्लगइन के रूप में उपयोग किया जा सकता है:

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

पर्यावरण के अनुसार स्थापित करें

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

codex mcp add --url "https://mcp.tigerdata.com/docs" pg-aiguide

{
  "mcpServers": {
    "pg-aiguide": {
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

gemini mcp add -s user pg-aiguide "https://mcp.tigerdata.com/docs" -t http

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pg-aiguide": {
      "type": "remote",
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

code --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

code-insiders --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

{
  "mcpServers": {
    "pg-aiguide": {
      "serverUrl": "https://mcp.tigerdata.com/docs"
    }
  }
}

💡 आपका पहला प्रॉम्प्ट

स्थापित होने के बाद, pg-aiguide Postgres प्रश्नों का उत्तर दे सकता है या स्कीमा डिज़ाइन कर सकता है।

सरल स्कीमा उदाहरण प्रॉम्प्ट

उपयोगकर्ता नाम और अद्वितीय ईमेल पते संग्रहीत करने के लिए एक Postgres तालिका स्कीमा बनाएं।

जटिल स्कीमा उदाहरण प्रॉम्प्ट

आप एक वरिष्ठ सॉफ्टवेयर इंजीनियर हैं। आपको एक IoT डिवाइस कंपनी के लिए Postgres स्कीमा उत्पन्न करने का कार्य दिया गया है। डिवाइस फैक्ट्री फ्लोर पर पर्यावरणीय डेटा एकत्र करते हैं। डेटा में तापमान, आर्द्रता, दबाव शामिल हैं, जो मुख्य डेटा बिंदुओं के साथ-साथ अन्य माप हैं जो डिवाइस से डिवाइस में भिन्न होते हैं। प्रत्येक डिवाइस का एक अद्वितीय आईडी और एक मानव-पठनीय नाम होता है। हम डेटा एकत्र होने का समय भी रिकॉर्ड करना चाहते हैं। हाल के डेटा का विश्लेषण माप के आधार पर आउटलायर्स और विसंगतियों को खोजने के साथ-साथ एड-हॉक विश्लेषण के लिए विशेष डिवाइसों के डेटा का विश्लेषण करना शामिल है। ऐतिहासिक डेटा विश्लेषण में एक डिवाइस के लिए डेटा का इतिहास विश्लेषण या लंबी अवधि में सभी डिवाइसों के लिए आँकड़े प्राप्त करना शामिल है।

विशेषताएं

दस्तावेज़ खोज (MCP टूल्स)

• search_docs एकीकृत खोज उपकरण जो कई दस्तावेज़ स्रोतों में सिमेंटिक (वेक्टर समानता) और कीवर्ड (BM25) खोज का समर्थन करता है:
  • postgres - आधिकारिक PostgreSQL मैनुअल, संस्करण द्वारा सीमित
  • tiger - Tiger Data का दस्तावेज़ीकरण (TimescaleDB और इकोसिस्टम)
  • postgis - PostGIS स्थानिक एक्सटेंशन दस्तावेज़ीकरण

स्किल्स (AI-अनुकूलित सर्वोत्तम अभ्यास)

• view_skill
  चयनित, विचार-आधारित PostgreSQL सर्वोत्तम-अभ्यास स्किल्स को उजागर करता है जो AI कोडिंग सहायकों द्वारा स्वचालित रूप से उपयोग किए जाते हैं।

  ये स्किल्स निम्नलिखित पर मार्गदर्शन प्रदान करते हैं:

  • मौजूदा PostgreSQL स्कीमा और ऑब्जेक्ट्स की खोज
  • स्कीमा डिज़ाइन
  • इंडेक्सिंग रणनीतियाँ
  • डेटा प्रकार
  • डेटा अखंडता और बाधाएं
  • नामकरण परंपराएं
  • प्रदर्शन ट्यूनिंग
  • आधुनिक PostgreSQL सुविधाएं

🔌 इकोसिस्टम दस्तावेज़ीकरण

आज समर्थित:

• TimescaleDB (दस्तावेज़ + स्किल्स)
• PostGIS (दस्तावेज़)

जल्द आ रहा है:

• pgvector

हम अतिरिक्त एक्सटेंशन और टूल्स के लिए योगदान का स्वागत करते हैं।

🛠 विकास

DEVELOPMENT.md देखें:

• MCP सर्वर को स्थानीय रूप से चलाना
• नई स्किल्स जोड़ना
• नए दस्तावेज़ जोड़ना

🤝 योगदान

हम स्वागत करते हैं:

• नए Postgres सर्वोत्तम-अभ्यास स्किल्स
• अतिरिक्त दस्तावेज़ कोर्पोरा
• खोज गुणवत्ता सुधार
• बग रिपोर्ट और फीचर विचार

📄 लाइसेंस

Apache 2.0