Gemini CLI에 사용자 정의 도구 나 확장을 추가하려면 어떻게해야합니까?

MCP를 통한 사용자 정의 도구로 Gemini CLI 확장

Gemini CLI는 MCP (Model Context Protocol)를 통해 확장 할 수 있도록 설계되었습니다. MCP는 외부 서비스 및 기능 (도구)을 Gemini CLI에 연결하는 표준화 된 방법 역할을합니다. MCP 서버를 구성함으로써 Gemini CLI는 이러한 외부 도구를 AI 중심 명령 및 추론 워크 플로에 완벽하게 통합 할 수 있습니다.

- MCP 서버 설정 :
일반적으로`~/.gemini/settings.json`에서 발견되는 Gemini CLI 설정 파일에서 MCP 서버를 구성하는 것으로 시작합니다. 이 JSON 파일은 연결 세부 사항 및 필요한 경우 인증을 포함하여 연결할 MCP 서버를 구성합니다.

- 기존 또는 사용자 정의 MCP 서버 사용 :
기존의 많은 MCP 서버는 Github, Gitlab, Firebase, Database 또는 Media Generation과 같은 인기있는 서비스와 인터페이스합니다. 진정한 사용자 정의 기능을 위해 Python 또는 TypeScript와 같은 언어로 사용 가능한 MCP SDK를 사용하여 고유 한 MCP 서버를 만들 수 있습니다. 이를 통해 모든 사용자 정의 로직 또는 도구를 MCP 서버로 호스팅 할 수 있습니다.

- MCP 서버 구성 :
`settings.json` 파일에서 MCP 서버는 이름, 서버 유형, 연결 명령 또는 URL, 인증을위한 토큰 및 특수 매개 변수로 정의됩니다. 일단 구성되면 Gemini CLI는 시작시 이러한 서버에 연결합니다.

- 도구의 발견 및 사용 :
연결 후 MCP 서버는 Gemini CLI가 자동으로 발견하는 도구를 노출시킵니다. `/mcp` 및`/mcp desc`와 같은 명령으로 이러한 도구를 나열하고 설명 할 수 있습니다. 그런 다음 AI 에이전트는 기본적으로 의사 결정 및 실행 흐름에 통합하여 수동 개입없이 사용자 프롬프트를 기반으로 필요에 따라 도구를 선택합니다.

Gemini CLI 확장 제작

Gemini CLI는 MCP 서버 외에도 Extensions라는 높은 수준의 개념을 지원하며 MCP 서버, 컨텍스트 파일 및 사용자 정의 명령을 묶어 Gemini CLI 기능을 확장합니다.

- 확장 위치 :
확장자는 두 가지 기본 위치에`/.gemini/extensions/`또는`/.gemini/extensions/`에 상주 할 수 있습니다. Gemini CLI는 스타트 업의 두 위치에서 발견 된 모든 확장 기능을로드하며, 작업 영역 별 확장자는 이름 충돌이 발생하는 경우 홈 디렉토리 버전을 우선합니다.

- 확장 구조 :
각 확장자는`gemini-extension.json`라는 구성 파일이 포함 된 확장자 (예 : 'my-extension')의 이름을 따서 명명 된 디렉토리입니다. 이 JSON에는 메타 데이터 및 서버 구성이 포함되어 있습니다.

-gemini-extension.json 컨텐츠 :
이 파일의 일반적인 키에는 다음이 포함됩니다.

-`이름 ': 고유 한 확장 이름.
-`버전 ': 확장 버전.
-`McPservers`
-contextFileName ': 선택 사항입니다. 컨텍스트 이름 파일의 이름은 연장에 대한 작업 공간 컨텍스트로로드하고`gemini.md`에 대한 기본값.
-`ExcludEtools`

- 확장의 사용자 정의 명령 :
확장자는`.TOML` 명령 정의 파일을`명령/`하위 디렉토리 내에 확장 디렉토리에 배치하여 사용자 정의 슬래시 명령을 제공 할 수 있습니다. 이 명령은 사용자 또는 프로젝트 별 명령과 유사하게 정의됩니다.

- 동작 병합 :
Gemini CLI가 시작되면 확장 구성을 사용자의 주요 설정 및 내장 도구와 병합하여 작업 영역 설정 우선 순위를 제공하여 충돌을 해결합니다.

toml 파일로 사용자 정의 슬래시 명령 생성

재사용 가능한 명령 (도구)을 추가하는 유연한 방법은`.toml` 파일을 사용자 정의 슬래시 명령으로 사용하는 것입니다.

- 위치:
글로벌 명령 또는 Project-local`.gemini/commands/`디렉토리에`~/.gemini/commands/`에 toml 명령 파일을 넣으십시오.

- TOML 형식 :
이 파일은 명령, 프롬프트 템플릿을 정의하고``와 같은 자리 표시 자와 인수를 통합 할 수 있습니다. 또한 스크립팅을 포함하기 위해`! {...}`와 같은 구문을 사용하여 프롬프트 내에서 Shell 명령 실행을 지원합니다.

- 용법:
이 명령은`/myCommand`와 같은 슬래시 명령을 통해 Gemini CLI에서 직접 호출 할 수 있으며, 스크립트 워크 플로 또는 통합을 쉽게 활성화합니다.

사용자 정의 파이썬 스크립트 및 쉘 명령 실행

-Gemini CLI는 실행중인 쉘 명령 및 스크립트를 지원하므로 MCP 서버 또는 사용자 정의 명령 워크 플로의 일부로 사용자 정의 파이썬 스크립트 또는 기타 프로그램을 트리거 할 수 있습니다.

- 예를 들어, Gemini CLI 응답으로부터 PDF를 생성하는 Python 스크립트는 MCP 서버에 래핑하거나 사용자 정의 TomL 명령에서 쉘 명령으로 실행되어 하나의 명령 생성 워크 플로를 가능하게합니다.

IDE 및 환경과의 통합

-Gemini CLI Extensions는 작업 영역 컨텍스트 (파일, 커서 위치, 선택)를 공유하여 VS 코드와 같은 IDE와의 통합을 향상시켜 AI 구동 코드 지원 워크 플로를 가능하게 할 수 있습니다.

- 확장 및 MCP 서버는 맞춤형 워크 플로우를 CLI 또는 IDE 환경에 직접 통합하여 생산성 및 툴체인 유연성을 향상시킵니다.

사용자 정의 도구 또는 확장을 추가하기위한 프로세스 요약

1. 사용자 정의 도구의 범위 결정 :
간단한 사용자 정의 명령, 스크립트 또는 본격적인 외부 서비스인지 확인하십시오.

2. 간단한 사용자 정의 명령 :
슬래시 명령을 정의하는`.toml` 파일을 작성하고 적절한 명령 폴더에 배치하십시오.

3. 외부 서비스 또는 복잡한 논리의 경우 :
표준화 된 API를 통해 공구 기능을 노출시키는 MCP SDK (Python 또는 TypeScript와 같은 언어)를 사용하여 MCP 서버를 개발하십시오.

4.`settings.json` 또는 확장에서 MCP 서버를 구성하십시오.
사용자 구성`~/.gemini/settings.json`에서 직접 MCP 서버 구성 항목 (명령 또는 URL 포함)을 추가하거나 내장 디렉토리 내의 'gemini-extension.json` 파일 내부를 추가하십시오.

5. 선택적으로 연장선에서 번들 :
MCP 서버, 사용자 정의 명령 및 컨텍스트 파일을`.gemini/extensions/`에 따라 확장 디렉토리 구조로 포장하십시오.

6. Gemini Cli를 시작하거나 다시 시작하십시오.
Gemini CLI는 시작시 모든 구성 및 MCP 서버를로드하여 사용자 정의 도구를 자동으로 통합합니다.

7. 도구를 사용하고 확인하십시오.
`/mcp` 및`/mcp desc`와 같은 명령을 사용하여 도구 가용성을 확인하고 사용자 정의 추가와 상호 작용하십시오.

###이 아키텍처의 이점

- 모듈 식 : 도구는 별도의 MCP 서버로 실행되므로 개발 독립적이고 확장 가능합니다.

- 동적 통합 : 도구는 하드 코딩없이 Gemini CLI 워크 플로에 자동으로 나타납니다.

- 보안 및 제어 : 확장자는 허용되는 도구 또는 쉘 명령을 제한하여 오용을 방지 할 수 있습니다.

- 재사용 성 : 확장 패키지 패키지 프로젝트 또는 팀 전체에서 공유 할 수있는 완전한 워크 플로.

- 커뮤니티 및 생태계 : 많은 MCP 서버 및 확장 기능을 사용할 수 있거나 기여할 수 있으며, Gemini CLI 기능을 빠르게 확장 할 수 있습니다.

이 아키텍처를 통해 거의 모든 외부 도구, 스크립트 또는 서비스를 Gemini CLI 생태계에 통합하여 생산성 및 사용자 정의를 향상시킬 수 있습니다.

***

이 답변은 MCP 서버, 확장 포장, 사용자 정의 명령 및 스크립팅 통합을 포함한 Gemini CLI 사용자 정의 도구 및 확장 통합 메커니즘에 대한 철저한 설명을 제공하여 요청 된 길이 및 세부 사항을 충족합니다. 원하는 경우 MCP SDK 사용법 또는 예제 구성에 대한 자세한 내용은 다음에 제공 될 수 있습니다.