Gemini Cloud Assist MCP Server

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

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

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

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

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

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

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

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ 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

เซิร์ฟเวอร์ Gemini Cloud Assist MCP ใช้ข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (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 ของคุณ

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

Gemini CLI

ติดตั้งเซิร์ฟเวอร์ MCP เป็น ส่วนขยาย Gemini CLI:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

หรือคุณสามารถเพิ่มการกำหนดค่าด้วยตนเองลงใน ~/.gemini/settings.json ของคุณ:

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

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 สำหรับแอปเดสก์ท็อป
2. กำหนดค่า URI://anysphere.cursor-mcp/oauth/callback เป็น 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

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

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

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

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

เครื่องมือ 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

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

เครื่องมือ Gemini Cloud Assist MCP ใช้ประโยชน์จากไฟล์ 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 ของเรา
• ก่อนส่งคำขอดึงข้อมูล โปรดตรวจสอบ คู่มือการมีส่วนร่วม ของเรา

ใบอนุญาต

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