Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon ฉันจะเพิ่มเครื่องมือหรือส่วนขยายที่กำหนดเองใน Gemini CLI ได้อย่างไร


ฉันจะเพิ่มเครื่องมือหรือส่วนขยายที่กำหนดเองใน Gemini CLI ได้อย่างไร


ในการเพิ่มเครื่องมือหรือส่วนขยายที่กำหนดเองให้กับราศีเมถุน CLI กลไกหลักคือผ่านโมเดลบริบทโปรโตคอล (MCP) และส่วนขยายที่กำหนดเองที่ Gemini CLI รองรับ ด้านล่างนี้เป็นคู่มือโดยละเอียดพร้อมประเด็นสำคัญและขั้นตอนในการเพิ่มเครื่องมือหรือส่วนขยายที่กำหนดเองให้กับ Gemini CLI:

ขยาย Gemini CLI ด้วยเครื่องมือที่กำหนดเองผ่าน MCP

Gemini CLI ได้รับการออกแบบให้สามารถขยายได้ผ่านโมเดลบริบทโปรโตคอล (MCP) MCP ทำหน้าที่เป็นวิธีที่ได้มาตรฐานในการเชื่อมต่อบริการและความสามารถภายนอก (เครื่องมือ) กับ Gemini CLI ด้วยการกำหนดค่าเซิร์ฟเวอร์ MCP Gemini CLI สามารถรวมเครื่องมือภายนอกเหล่านี้เข้ากับคำสั่ง AI ที่ขับเคลื่อนด้วย AI และเวิร์กโฟลว์ให้เหตุผล

- การตั้งค่าเซิร์ฟเวอร์ MCP:
คุณเริ่มต้นด้วยการกำหนดค่าเซิร์ฟเวอร์ MCP ในไฟล์การตั้งค่า Gemini CLI ซึ่งโดยทั่วไปจะพบได้ที่ `~/.gemini/settings.json` ไฟล์ JSON นี้กำหนดค่าเซิร์ฟเวอร์ MCP ที่เชื่อมต่อด้วยรวมถึงรายละเอียดการเชื่อมต่อและการรับรองความถูกต้องหากจำเป็น

- การใช้เซิร์ฟเวอร์ MCP ที่มีอยู่หรือกำหนดเอง:
อินเทอร์เฟซ MCP เซิร์ฟเวอร์ที่มีอยู่จำนวนมากกับบริการยอดนิยมเช่น GitHub, Gitlab, Firebase, ฐานข้อมูลหรือการสร้างสื่อ สำหรับฟังก์ชั่นที่กำหนดเองอย่างแท้จริงคุณสามารถสร้างเซิร์ฟเวอร์ MCP ของคุณเองโดยใช้ MCP SDK ที่มีอยู่ในภาษาเช่น Python หรือ TypeScript สิ่งนี้อนุญาตให้โฮสต์ตรรกะหรือเครื่องมือที่กำหนดเองเป็นเซิร์ฟเวอร์ MCP

- การกำหนดค่าเซิร์ฟเวอร์ MCP:
ในไฟล์ `settings.json` เซิร์ฟเวอร์ MCP จะถูกกำหนดด้วยชื่อประเภทเซิร์ฟเวอร์คำสั่งการเชื่อมต่อหรือ URL โทเค็นสำหรับการตรวจสอบและพารามิเตอร์พิเศษใด ๆ เมื่อกำหนดค่าแล้ว Gemini CLI จะเชื่อมต่อกับเซิร์ฟเวอร์เหล่านี้เมื่อเริ่มต้น

- การค้นพบและการใช้เครื่องมือ:
หลังจากการเชื่อมต่อเซิร์ฟเวอร์ MCP จะเปิดเผยเครื่องมือที่ Gemini CLI ค้นพบโดยอัตโนมัติ คุณสามารถแสดงรายการและอธิบายเครื่องมือเหล่านี้ด้วยคำสั่งเช่น `/mcp` และ`/mcp desc` จากนั้นเอเจนต์ AI จะรวมเข้ากับการตัดสินใจและการดำเนินการตามกระแสการเลือกเครื่องมือตามความจำเป็นตามพรอมต์ของผู้ใช้โดยไม่ต้องแทรกแซงด้วยตนเอง

การสร้างส่วนขยาย Gemini CLI

นอกเหนือจากเซิร์ฟเวอร์ MCP แล้ว Gemini CLI สนับสนุนแนวคิดระดับสูงกว่าที่เรียกว่าส่วนขยายซึ่งรวมตัวกันเซิร์ฟเวอร์ MCP ไฟล์บริบทและคำสั่งที่กำหนดเองเพื่อขยายฟังก์ชันการทำงานของ Gemini CLI

- ตำแหน่งส่วนขยาย:
ส่วนขยายสามารถอยู่ในสองสถานที่หลัก: `/.Gemini/ส่วนขยาย/` หรือ `/.gemini/ส่วนขยาย/` Gemini CLI โหลดส่วนขยายทั้งหมดที่พบในทั้งสองสถานที่ในการเริ่มต้นโดยมีส่วนขยายเฉพาะพื้นที่ทำงานที่เอาชนะไดเรกทอรีโฮมไดเรกทอรีหากชื่อมีความขัดแย้งเกิดขึ้น

- โครงสร้างส่วนขยาย:
แต่ละส่วนขยายเป็นไดเรกทอรีที่ตั้งชื่อตามส่วนขยาย (เช่น `my-extension`) ที่มีไฟล์กำหนดค่าชื่อ` gemini-extension.json` JSON นี้รวมถึงข้อมูลเมตาและการกำหนดค่าเซิร์ฟเวอร์

- Gemini-extension.json เนื้อหา:
คีย์ทั่วไปในไฟล์นี้รวมถึง:

- `ชื่อ ': ชื่อส่วนขยายที่ไม่ซ้ำกัน
- `เวอร์ชัน ': เวอร์ชันส่วนขยาย
- `McPservers`: แผนที่ของเซิร์ฟเวอร์ MCP ที่กำหนดค่าโดยส่วนขยายเช่นคำสั่งเพื่อเรียกใช้เซิร์ฟเวอร์ MCP ที่กำหนดเอง
- `contextfilename`: เป็นทางเลือก ชื่อไฟล์บริบทที่โหลดเป็นบริบทพื้นที่ทำงานสำหรับส่วนขยายค่าเริ่มต้นเป็น `gemini.md`
- `excludetools`: อาร์เรย์ระบุเครื่องมือหรือคำสั่งเครื่องมือเพื่อแยกออก, มีประโยชน์สำหรับการบล็อกการดำเนินการที่เป็นอันตรายหรือไม่พึงประสงค์

- คำสั่งที่กำหนดเองในส่วนขยาย:
ส่วนขยายสามารถให้คำสั่ง Slash ที่กำหนดเองโดยการวางไฟล์คำสั่งคำสั่ง `.toml` ภายในคำสั่ง` คำสั่ง/`ไดเรกทอรีย่อยภายในไดเรกทอรีส่วนขยาย คำสั่งเหล่านี้ถูกกำหนดเช่นเดียวกันกับคำสั่งผู้ใช้หรือโครงการเฉพาะโครงการ

- พฤติกรรมผสาน:
เมื่อ Gemini CLI เริ่มต้นจะรวมการกำหนดค่าส่วนขยายเข้ากับการตั้งค่าหลักของผู้ใช้และเครื่องมือในตัวเพื่อแก้ไขความขัดแย้งโดยให้ลำดับความสำคัญของการตั้งค่าพื้นที่ทำงาน

การสร้างคำสั่ง Slash ที่กำหนดเองด้วยไฟล์ TOML

วิธีที่ยืดหยุ่นในการเพิ่มคำสั่งที่นำกลับมาใช้ใหม่ได้ (เครื่องมือ) คือการใช้ไฟล์ `.toml` เป็นคำสั่ง Slash ที่กำหนดเอง

- ที่ตั้ง:
ใส่ไฟล์คำสั่ง toml ใน `~/.gemini/commands/` สำหรับคำสั่งทั่วโลกหรือในโครงการ local `.gemini/commands/` ไดเรกทอรี

- รูปแบบ Toml:
ไฟล์เหล่านี้กำหนดคำสั่งเทมเพลตพรอมต์และอาจรวมอาร์กิวเมนต์กับตัวยึดสถานที่เช่น `` พวกเขายังรองรับการดำเนินการคำสั่งเชลล์ภายในพรอมต์โดยใช้ไวยากรณ์เช่น `! {... }` เพื่อฝังสคริปต์

- การใช้งาน:
คำสั่งเหล่านี้สามารถเรียกใช้โดยตรงใน Gemini CLI ผ่านคำสั่ง Slash เช่น `/myCommand` เปิดใช้งานเวิร์กโฟลว์สคริปต์หรือการรวมเข้าด้วยกันได้อย่างง่ายดาย

เรียกใช้สคริปต์ Python ที่กำหนดเองและคำสั่งเชลล์

- เนื่องจาก Gemini CLI รองรับการเรียกใช้คำสั่งเชลล์และสคริปต์คุณสามารถเรียกใช้สคริปต์ Python ที่กำหนดเองหรือโปรแกรมอื่น ๆ ซึ่งเป็นส่วนหนึ่งของเซิร์ฟเวอร์ MCP ของคุณหรือเวิร์กโฟลว์คำสั่งที่กำหนดเอง

- ตัวอย่างเช่นสคริปต์ Python ที่สร้าง PDFs จากการตอบสนองของราศีเมถุน CLI สามารถห่อหุ้มในเซิร์ฟเวอร์ MCP หรือดำเนินการเป็นคำสั่งเชลล์ในคำสั่ง TOML ที่กำหนดเอง

การรวมเข้ากับ IDE และสภาพแวดล้อม

- ส่วนขยาย Gemini CLI ยังสามารถปรับปรุงการรวมเข้ากับ IDEs เช่น VS Code โดยการแชร์บริบทพื้นที่ทำงาน (ไฟล์ที่ตั้งเคอร์เซอร์การเลือก) เปิดใช้งานเวิร์กโฟลว์ความช่วยเหลือรหัส AI ที่ขับเคลื่อนด้วย AI

- ส่วนขยายและเซิร์ฟเวอร์ MCP ช่วยรวมเวิร์กโฟลว์ที่ปรับแต่งให้เข้ากับสภาพแวดล้อม CLI หรือ IDE โดยตรงปรับปรุงประสิทธิภาพการผลิตและความยืดหยุ่นของเครื่องมือ

สรุปกระบวนการเพื่อเพิ่มเครื่องมือหรือส่วนขยายที่กำหนดเอง

1. ตัดสินใจขอบเขตของเครื่องมือที่กำหนดเอง:
ตรวจสอบว่าเป็นคำสั่งที่กำหนดเองอย่างง่ายสคริปต์หรือบริการภายนอกเต็มรูปแบบ

2. สำหรับคำสั่งแบบกำหนดเองอย่างง่าย:
สร้างไฟล์ `.toml` ที่กำหนดคำสั่ง Slash และวางไว้ในโฟลเดอร์คำสั่งที่เหมาะสม

3. สำหรับบริการภายนอกหรือตรรกะที่ซับซ้อน:
พัฒนาเซิร์ฟเวอร์ MCP โดยใช้ MCP SDK (สนับสนุนภาษาเช่น Python หรือ typeScript) ที่เปิดเผยความสามารถของเครื่องมือผ่าน API มาตรฐาน

4. กำหนดค่าเซิร์ฟเวอร์ MCP ใน `settings.json` หรือส่วนขยาย:
เพิ่มรายการการกำหนดค่าเซิร์ฟเวอร์ MCP (พร้อมคำสั่งหรือ URL) โดยตรงในการกำหนดค่าผู้ใช้ `~/.gemini/settings.json` หรือภายในไฟล์` gemini-extension.json` ภายในไดเรกทอรีส่วนขยาย

5. ตัวเลือกมัดในส่วนขยาย:
บรรจุเซิร์ฟเวอร์ MCP คำสั่งที่กำหนดเองและไฟล์บริบทลงในโครงสร้างไดเรกทอรีส่วนขยายภายใต้ `. gemini/ส่วนขยาย/`

6. เริ่มต้นหรือรีสตาร์ท Gemini CLI:
Gemini CLI โหลดการกำหนดค่าและเซิร์ฟเวอร์ MCP ทั้งหมดในการเริ่มต้นเครื่องมือที่กำหนดเองโดยอัตโนมัติ

7. ใช้และตรวจสอบเครื่องมือ:
ใช้คำสั่งเช่น `/mcp` และ`/mcp desc` เพื่อยืนยันความพร้อมใช้งานของเครื่องมือและโต้ตอบกับการเพิ่มที่กำหนดเองของคุณ

ประโยชน์ของสถาปัตยกรรมนี้

- Modularity: เครื่องมือทำงานเป็นเซิร์ฟเวอร์ MCP แยกต่างหากทำให้การพัฒนาเป็นอิสระและปรับขนาดได้

- การรวมแบบไดนามิก: เครื่องมือจะปรากฏขึ้นโดยอัตโนมัติในเวิร์กโฟลว์ Gemini CLI โดยไม่ต้องใช้การเข้ารหัส

- ความปลอดภัยและการควบคุม: ส่วนขยายสามารถ จำกัด เครื่องมือหรือคำสั่งเชลล์ที่อนุญาตให้ป้องกันการใช้งานในทางที่ผิด

- ความสามารถในการนำกลับมาใช้ใหม่: แพคเกจส่วนขยายเวิร์กโฟลว์ที่สมบูรณ์, แบ่งปันได้ในโครงการหรือทีม

- ชุมชนและระบบนิเวศ: เซิร์ฟเวอร์ MCP และส่วนขยายจำนวนมากพร้อมใช้งานหรือสามารถมีส่วนร่วมได้ขยายขีดความสามารถของ Gemini CLI อย่างรวดเร็ว

สถาปัตยกรรมนี้อนุญาตให้ใช้เครื่องมือภายนอกสคริปต์หรือบริการใด ๆ ที่รวมเข้ากับระบบนิเวศของ Gemini CLI, เพิ่มประสิทธิภาพการผลิตและการปรับแต่ง

-

คำตอบนี้ให้คำอธิบายอย่างละเอียดเกี่ยวกับเครื่องมือที่กำหนดเอง Gemini CLI และกลไกการรวมส่วนขยายรวมถึงเซิร์ฟเวอร์ MCP, บรรจุภัณฑ์ส่วนขยาย, คำสั่งที่กำหนดเองและการรวมสคริปต์, การประชุมความยาวและรายละเอียดที่ร้องขอ หากต้องการคุณสามารถให้ข้อมูลเฉพาะเพิ่มเติมเกี่ยวกับการใช้งาน MCP SDK หรือการกำหนดค่าตัวอย่างต่อไป

ข้อมูลทั้งหมดขึ้นอยู่กับเอกสารประกอบของ Gemini CLI ที่เชื่อถือได้และแหล่งชุมชนที่มีอยู่ในเดือนกันยายน 2568