pg-aiguide MCP Server

pg-aiguide

ความเชี่ยวชาญ PostgreSQL ที่ปรับให้เหมาะกับ AI สำหรับผู้ช่วยเขียนโค้ด

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 แก้ไขสิ่งนั้นโดยให้ความรู้ PostgreSQL เชิงลึกตามเวอร์ชันและรูปแบบที่ผ่านการพิสูจน์แล้วแก่ตัวแทน AI

ดูความแตกต่าง

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

🚀 เริ่มต้นอย่างรวดเร็ว

ทักษะตัวแทน

ติดตั้งทักษะแนวปฏิบัติที่ดีที่สุดของ PostgreSQL ที่คัดสรรแล้วสำหรับตัวแทนเขียนโค้ด AI ของคุณ:

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

หรือเลือกทักษะแต่ละรายการแบบโต้ตอบ:

npx skills add timescale/pg-aiguide

ทำงานร่วมกับ Claude Code, Cursor, Codex, Gemini CLI, VS Code และ ตัวแทนอื่นๆ อีกกว่า 40 รายการ

เพื่อความรู้ PostgreSQL ที่ลึกซึ้งยิ่งขึ้น ให้เพิ่ม เซิร์ฟเวอร์ MCP เพื่อให้ตัวแทนของคุณค้นหาเชิงความหมายทั่วทั้งคู่มือ PostgreSQL, TimescaleDB และ PostGIS อย่างเป็นทางการ

เซิร์ฟเวอร์ 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

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 สำหรับจัดเก็บชื่อผู้ใช้และที่อยู่อีเมลที่ไม่ซ้ำกัน

พรอมต์ตัวอย่างสคีมาที่ซับซ้อน

คุณเป็นวิศวกรซอฟต์แวร์อาวุโส คุณได้รับมอบหมายให้สร้างสคีมา Postgres สำหรับบริษัทอุปกรณ์ IoT อุปกรณ์เก็บข้อมูลสิ่งแวดล้อมบนพื้นโรงงาน ข้อมูลรวมถึงอุณหภูมิ ความชื้น ความดัน เป็น จุดข้อมูลหลักรวมถึงการวัดอื่นๆ ที่แตกต่างกันไปในแต่ละอุปกรณ์ แต่ละอุปกรณ์มี id เฉพาะ และชื่อที่มนุษย์อ่านได้ เราต้องการบันทึกเวลาที่เก็บข้อมูลด้วยเช่นกัน การวิเคราะห์ข้อมูลล่าสุด รวมถึงการค้นหาค่าผิดปกติและความผิดปกติตามการวัด รวมถึงการวิเคราะห์ข้อมูลของอุปกรณ์เฉพาะสำหรับการวิเคราะห์เฉพาะกิจ การวิเคราะห์ข้อมูลประวัติรวมถึงการวิเคราะห์ประวัติข้อมูลสำหรับอุปกรณ์หนึ่งเครื่องหรือรับสถิติสำหรับอุปกรณ์ทั้งหมดในช่วงเวลาที่ยาวนาน

ฟีเจอร์

การค้นหาเอกสาร (เครื่องมือ MCP)

• search_docs เครื่องมือค้นหาแบบรวมที่รองรับการค้นหาเชิงความหมาย (ความคล้ายคลึงของเวกเตอร์) และคำสำคัญ (BM25) ทั่วทั้งแหล่งเอกสารหลายแห่ง:
  • postgres - คู่มือ PostgreSQL อย่างเป็นทางการ กำหนดขอบเขตตามเวอร์ชัน
  • tiger - เอกสารของ Tiger Data (TimescaleDB และระบบนิเวศ)
  • postgis - เอกสารส่วนขยายเชิงพื้นที่ PostGIS

ทักษะ (แนวปฏิบัติที่ดีที่สุดที่ปรับให้เหมาะกับ AI)

• view_skill
  เปิดเผยทักษะแนวปฏิบัติที่ดีที่สุดของ PostgreSQL ที่คัดสรรและมีความเห็นเฉพาะ ซึ่งผู้ช่วยเขียนโค้ด AI ใช้โดยอัตโนมัติ

  ทักษะเหล่านี้ให้คำแนะนำเกี่ยวกับ:

  • การออกแบบสคีมา
  • กลยุทธ์การสร้างดัชนี
  • ชนิดข้อมูล
  • ความสมบูรณ์ของข้อมูลและข้อจำกัด
  • ข้อตกลงการตั้งชื่อ
  • การปรับแต่งประสิทธิภาพ
  • ฟีเจอร์ PostgreSQL สมัยใหม่

🔌 เอกสารระบบนิเวศ

รองรับในวันนี้:

• TimescaleDB (เอกสาร + ทักษะ)
• PostGIS (เอกสาร)

เร็วๆ นี้:

• pgvector

เรายินดีรับการมีส่วนร่วมสำหรับส่วนขยายและเครื่องมือเพิ่มเติม

🛠 การพัฒนา

ดู DEVELOPMENT.md สำหรับ:

• การรันเซิร์ฟเวอร์ MCP ในเครื่อง
• การเพิ่มทักษะใหม่
• การเพิ่มเอกสารใหม่

🤝 การมีส่วนร่วม

เรายินดีรับ:

• ทักษะแนวปฏิบัติที่ดีที่สุดของ Postgres ใหม่
• คลังเอกสารเพิ่มเติม
• การปรับปรุงคุณภาพการค้นหา
• รายงานข้อบกพร่องและแนวคิดฟีเจอร์

📄 ใบอนุญาต

Apache 2.0