Gemini Cloud Assist

เซิร์ฟเวอร์ MCP ของ Gemini Cloud Assist

[!IMPORTANT] ประกาศการเปิดตัวอย่างส่วนตัว (Private Preview) API ของเซิร์ฟเวอร์ MCP ของ Gemini Cloud Assist อยู่ในช่วง Private Preview และอยู่ภายใต้บัญชีอนุญาต (allowlist) กรุณาติดต่อทีมบัญชี Google Cloud ของคุณเพื่อขอสิทธิ์การเข้าถึง

[!WARNING] ประกาศการเลิกใช้งานและการย้ายไปยังเซิร์ฟเวอร์ MCP ระยะไกล

เซิร์ฟเวอร์ MCP ของ Gemini Cloud Assist ได้ย้ายจากสถาปัตยกรรม Node.js ในเครื่องไปเป็นสถาปัตยกรรมเซิร์ฟเวอร์ MCP ระยะไกล (Remote MCP Server) เซิร์ฟเวอร์ Node.js ในเครื่องรุ่นเก่าจะไม่ได้รับการสนับสนุนในอีกไม่กี่เดือนข้างหน้า

หากต้องการใช้เซิร์ฟเวอร์ MCP ระยะไกลใหม่ กรุณาใช้เวอร์ชัน v0.8.0 หรือใหม่กว่า หากคุณต้องการใช้เซิร์ฟเวอร์ในเครื่องรุ่นเก่าต่อไประหว่างช่วงเปลี่ยนผ่าน กรุณากำหนดค่าของคุณให้ใช้เวอร์ชันที่เก่ากว่า

เซิร์ฟเวอร์นี้เชื่อมต่อไคลเอนต์ Model Context Protocol (MCP) เข้ากับ Gemini Cloud Assist APIs ช่วยให้คุณใช้ภาษาธรรมชาติในการทำความเข้าใจ จัดการ และแก้ไขปัญหาสภาพแวดล้อม Google Cloud ของคุณได้โดยตรงจากบรรทัดคำสั่งในเครื่อง

[!NOTE] ข้อกำหนดในการให้บริการของ Google Cloud Platform (ดูได้ที่ https://cloud.google.com/terms/) และข้อกำหนดด้านการประมวลผลข้อมูลและความปลอดภัย (ดูได้ที่ https://cloud.google.com/terms/data-processing-terms) ไม่มีผลบังคับใช้กับส่วนประกอบใดๆ ของซอฟต์แวร์เซิร์ฟเวอร์ MCP ของ Gemini Cloud Assist

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ Gemini Cloud Assist โปรดดู ภาพรวมของ Gemini Cloud Assist ในเอกสารประกอบของ Google Cloud

✨ คุณสมบัติหลัก

• ออกแบบโครงสร้างพื้นฐาน: สร้างและออกแบบการกำหนดค่าโครงสร้างพื้นฐานสำหรับ Google Cloud
• แก้ไขปัญหา: ดำเนินการตรวจสอบเชิงลึกเพื่อค้นหาสาเหตุที่แท้จริงของปัญหาที่ซับซ้อนในสภาพแวดล้อม Google Cloud ของคุณ
• จัดการทรัพยากร: สร้าง อัปเดต และลบทรัพยากร Google Cloud ได้โดยตรงจากเวิร์กโฟลว์แชทของคุณ (ต้องเปิดใช้งาน Agent Actions)
• ปรับต้นทุนให้เหมาะสม: วิเคราะห์ค่าใช้จ่าย ติดตามต้นทุน และระบุโอกาสในการเพิ่มประสิทธิภาพ เช่น ทรัพยากรที่ไม่ได้ใช้งาน
• รับความช่วยเหลือทั่วไป: ถามคำถามและรับคำแนะนำเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุด สถาปัตยกรรม และการดำเนินงานของ Google Cloud

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

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่าดังต่อไปนี้:

• ติดตั้งและกำหนดค่า Google Cloud SDK แล้ว
• มีโปรเจกต์ Google Cloud
• มีบทบาท IAM ต่อไปนี้ในบัญชีผู้ใช้ของคุณ:
  • roles/serviceusage.serviceUsageAdmin: จำเป็นสำหรับการเปิดใช้งาน Cloud Assist APIs
  • roles/geminicloudassist.user: จำเป็นสำหรับการส่งคำขอไปยัง Cloud Assist APIs

ขั้นตอนที่ 1: ยืนยันตัวตนกับ Google Cloud

เซิร์ฟเวอร์ MCP ของ Gemini Cloud Assist ใช้ข้อมูลประจำตัวเริ่มต้นของแอปพลิเคชัน (ADC) ในเครื่องเพื่อยืนยันตัวตนกับ Google Cloud อย่างปลอดภัย หากต้องการตั้งค่า ADC ให้รันคำสั่ง gcloud ต่อไปนี้:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

กำหนดค่าไคลเอนต์ MCP ของคุณ

การกำหนดค่าไคลเอนต์-เอเจนต์ขึ้นอยู่กับเอเจนต์ที่คุณใช้

Antigravity

เพิ่มเนื้อหาต่อไปนี้ลงใน mcp_config.json ของคุณ:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. ในโปรเจกต์ Google Cloud ของคุณ ให้สร้าง OAuth 2.0 client ID สำหรับแอปเดสก์ท็อป
2. กำหนดค่า URI://anysphere.cursor-mcp/oauth/callback เป็น URL การเปลี่ยนเส้นทาง (redirect URL)
3. เพิ่มหรือรวมบล็อกการกำหนดค่าต่อไปนี้:

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

ปฏิบัติตามคำแนะนำการกำหนดค่าสำหรับแอปพลิเคชันเฉพาะของคุณ:

• Claude.ai

เครื่องมือ MCP

เครื่องมือ MCP ของ Gemini Cloud Assist

Gemini Cloud Assist เป็นเอเจนต์ที่เข้าถึงได้ผ่านชุดเครื่องมือ MCP เอเจนต์ที่เรียกใช้โดยการเรียกเครื่องมือ MCP จะทำการเรียกเครื่องมือภายในไปยัง Google Cloud ด้วยตัวเอง เครื่องมือ MCP ต่อไปนี้ได้รับการเผยแพร่เพื่อให้เอเจนต์นำไปใช้:

เครื่องมือ	คำอธิบาย
ask_cloud_assist	อินเทอร์เฟซหลักสำหรับความช่วยเหลือของ Google Cloud และสำหรับเอเจนต์ Gemini Cloud Assist ฟังก์ชันทั้งหมดสามารถเข้าถึงได้ผ่านเครื่องมือนี้
design_infra	รองรับเวิร์กโฟลว์สำหรับการออกแบบและวางสถาปัตยกรรมโครงสร้างพื้นฐานบน Google Cloud
investigate_issue	รองรับเวิร์กโฟลว์สำหรับการแก้ไขปัญหาใน Google Cloud สามารถแก้ไขปัญหาแบบรวดเร็วหรือเจาะลึกผ่านทรัพยากร Investigation
invoke_operation	รองรับเวิร์กโฟลว์สำหรับการสร้าง อัปเดต และลบทรัพยากรใน Google Cloud ใช้งานได้เฉพาะเมื่อเปิดใช้งาน Agent Actions
optimize_costs	รองรับเวิร์กโฟลว์สำหรับการวิเคราะห์ ติดตาม และปรับต้นทุนของ Google Cloud ให้เหมาะสม ให้รายละเอียดค่าใช้จ่ายและระบุโอกาสในการประหยัดต้นทุน

เครื่องมือ MCP ของ Application Design Center

เครื่องมือ Application Design Center MCP ซึ่งมักถูกจัดระเบียบโดยเครื่องมือ design_infra ของ GCA จัดการวงจรชีวิตของแอปพลิเคชันโครงสร้างพื้นฐานโดยใช้ Application Design Center รวมถึงการจัดการเทมเพลต การปฏิบัติตามข้อกำหนดด้านความปลอดภัย การแก้ไข และการปรับใช้

เครื่องมือ	คำอธิบาย
setup_adc	เริ่มต้นสภาพแวดล้อม Application Design Center นี่เป็นขั้นตอนการตั้งค่าแบบครั้งเดียวที่ต้องดำเนินการก่อนใช้เครื่องมือ ADC อื่นๆ
manage_application	จัดการวงจรชีวิตการปรับใช้ของแอปพลิเคชัน ใช้เครื่องมือนี้เพื่อปรับใช้การออกแบบที่ผ่านการตรวจสอบโดยใช้ Application Design Center หรือดึงสถานะและรายละเอียดของการปรับใช้ที่มีอยู่ นี่เป็นขั้นตอนสุดท้ายที่เปลี่ยนการออกแบบของคุณให้เป็นโครงสร้างพื้นฐานที่ปรับใช้บน Google Cloud
manage_application_template	จัดการเนื้อหา Infrastructure as Code (IaC) ของการออกแบบโครงสร้างพื้นฐานของคุณ ใช้เพื่อบันทึกการออกแบบเป็นเทมเพลต Application Design Center ส่งออกการออกแบบเป็นไฟล์ Terraform หรืออัปเดตการออกแบบ (เช่น คอมโพเนนต์ การกำหนดค่าพารามิเตอร์ ฯลฯ)
assess_best_practices	ดำเนินการตรวจสอบความปลอดภัยและการกำหนดค่าอย่างครอบคลุมในการออกแบบแอปพลิเคชันของคุณก่อนการปรับใช้ ตรวจสอบการออกแบบกับกรอบงาน Security Command Center และการควบคุมที่เกี่ยวข้อง โดยส่งคืนรายงานพร้อมข้อค้นพบที่นำไปปฏิบัติได้สำหรับการแก้ไข
list_application_templates	แสดงรายการการออกแบบแอปพลิเคชันทั้งหมดที่มีอยู่

หมายเหตุ: เครื่องมือเหล่านี้ไม่ควรถือเป็น API ที่เสถียร พารามิเตอร์อาจถูกเปลี่ยนชื่อหรือแก้ไขเพื่อรองรับความสามารถที่พัฒนาขึ้นของ Gemini Cloud Assist

ทักษะของเอเจนต์

เครื่องมือ MCP ของ Gemini Cloud Assist ใช้ไฟล์ SKILL.md เพื่อแนะนำเอเจนต์ของคุณเกี่ยวกับวิธีใช้เครื่องมืออย่างถูกต้อง ทักษะช่วยแนะนำเอเจนต์ของคุณในการเชื่อมโยงเครื่องมือหลายตัวเข้าด้วยกันเป็นเวิร์กโฟลว์ การส่งข้อมูลท้องถิ่นที่เกี่ยวข้องไปยัง Gemini Cloud Assist และการเปิดใช้งานการเรียกใช้อย่างชัดเจน

ทักษะ	คำอธิบาย
designing-and-deploying-infrastructure	แนะนำเอเจนต์เกี่ยวกับวิธีออกแบบ ประเมิน ปรับใช้ และแก้ไขปัญหาโครงสร้างพื้นฐานคลาวด์โดยใช้ Application Design Center (ADC) และเครื่องมือ Gemini Cloud Assist
operating-google-cloud	ให้คำแนะนำสำหรับการจัดการทรัพยากร Google Cloud Platform (GCP) และ Kubernetes โดยใช้เครื่องมือ MCP เฉพาะทาง

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

• หากคุณพบข้อบกพร่อง กรุณาแจ้งปัญหาที่หน้า GitHub Issues ของเรา
• ก่อนส่ง pull request กรุณาตรวจสอบ คู่มือการมีส่วนร่วม ของเรา

ใบอนุญาต

โปรเจกต์นี้อยู่ภายใต้ใบอนุญาต Apache 2.0 และให้บริการตามสภาพที่เป็นอยู่ โดยไม่มีการรับประกันหรือการรับรองสำหรับการใช้งานหรือวัตถุประสงค์ใดๆ สำหรับรายละเอียด โปรดดูไฟล์ LICENSE