Como posso adicionar ferramentas ou extensões personalizadas ao gemini cli

Extender Gemini CLI com ferramentas personalizadas via MCP

O CLI Gemini foi projetado para ser extensível através do Model Context Protocol (MCP). O MCP atua como uma maneira padronizada de conectar serviços e recursos externos (ferramentas) à CLI Gemini. Ao configurar os servidores MCP, a CLI Gemini pode integrar essas ferramentas externas sem problemas ao comando orientado pela IA e no fluxo de trabalho de raciocínio.

- Configurando servidores MCP:
Você começa configurando servidores MCP no arquivo de configurações de Gemini CLI, normalmente encontrado em `~/.gemini/Settings.json`. Este arquivo JSON configura com quais servidores MCP se conectarem, incluindo detalhes de conexão e autenticação, se necessário.

- Usando servidores MCP existentes ou personalizados:
Muitos servidores MCP existentes fazem interface com serviços populares como Github, Gitlab, Firebase, Banco de Dados ou Geração de Mídia. Para uma funcionalidade verdadeiramente personalizada, você pode criar seus próprios servidores MCP usando o MCP SDK disponível em idiomas como Python ou TypeScript. Isso permite hospedar qualquer lógica ou ferramenta personalizada como um servidor MCP.

- Configurando servidores MCP:
No arquivo `Settings.json`, os servidores MCP são definidos com seus nomes, tipos de servidores, comandos de conexão ou URLs, tokens para autenticação e quaisquer parâmetros especializados. Uma vez configurado, a CLI Gemini se conectará a esses servidores na inicialização.

- Descoberta e uso de ferramentas:
Após a conexão, os servidores MCP expõem as ferramentas que a CLI Gemini descobre automaticamente. Você pode listar e descrever essas ferramentas com comandos como `/mcp` e`/mcp desc`. O agente da IA ​​os integra nativamente ao seu fluxo de tomada de decisão e execução, selecionando ferramentas conforme necessário com base nos avisos do usuário sem intervenção manual.

Criando extensões de gêmeos CLI

Além dos servidores MCP, a CLI Gemini suporta um conceito de nível superior chamado Extensões, que juntam servidores MCP, arquivos de contexto e comandos personalizados para estender a funcionalidade Gemini CLI.

- Localização de extensão:
As extensões podem residir em dois locais primários: `/.gemini/extensões/` ou `/.gemini/extensões/`. A CLI Gemini carrega todas as extensões encontradas em ambos os locais na inicialização, com extensões específicas da área de trabalho substituindo versões do diretório residencial se surgirem conflitos de nome.

- Estrutura de extensão:
Cada extensão é um diretório nomeado após a extensão (por exemplo, `my-extension`) que contém um arquivo de configuração chamado` gemini-Extension.json`. Este JSON inclui configurações de metadados e servidores.

- Conteúdo Gemini-Extension.json:
As chaves típicas deste arquivo incluem:

- `name`: nome de extensão exclusiva.
- `versão`: versão de extensão.
- `McPservers`: um mapa dos servidores MCP configurados pela extensão, por exemplo, comandos para iniciar os servidores MCP personalizados.
- `contextFileName`: opcional. Nome do arquivo de contexto carregado como contexto da área de trabalho para a extensão, padrão para `gemini.md`.
- `excluiTools`: matriz especificando ferramentas ou comandos de ferramentas para excluir, útil para bloquear operações perigosas ou indesejadas.

- Comandos personalizados em extensões:
As extensões podem fornecer comandos de slash personalizados colocando arquivos de definição de comando `.toml` dentro de um subdiretório` comandos/`no diretório de extensão. Esses comandos são definidos de maneira semelhante aos comandos específicos do usuário ou do projeto.

- Mesclar comportamento:
Quando a CLI Gemini inicia, ele mescla configurações de extensão com as principais configurações do usuário e ferramentas internas, resolvendo conflitos, dando prioridade nas configurações do espaço de trabalho.

Criando comandos de barra personalizados com arquivos Toml

Uma maneira flexível de adicionar comandos reutilizáveis ​​(ferramentas) é usando os arquivos `.toml` como comandos de barra personalizados.

- Localização:
Coloque os arquivos de comando TOML em `~/.gemini/comandos/` para comandos globais ou no diretório do projeto-Local `.gemini/comandos/`.

- Toml Format:
Esses arquivos definem o comando, modelos de prompt e podem incorporar argumentos com espaços reservados como ``. Eles também suportam a execução do comando Shell dentro do prompt usando sintaxe como `! {...}` para incorporar scripts.

- Uso:
Esses comandos podem ser invocados diretamente na CLI Gemini através de comandos Slash como `/myCommand ', permitindo que fluxos de trabalho com script ou integrações facilmente.

executando scripts python personalizados e comandos de shell

- Como a CLI da Gemini suporta a execução de comandos e scripts do shell, você pode acionar scripts Python personalizados ou outros programas como parte do seu servidor MCP ou fluxos de trabalho de comando personalizados.

- Por exemplo, um script Python que gera PDFs a partir de respostas da CLI Gemini pode ser envolvido em um servidor MCP ou executado como um comando Shell em um comando TOML personalizado, permitindo fluxos de trabalho de geração de um comando.

integração com IDEs e ambiente

- As extensões de Gemini CLI também podem melhorar a integração com IDEs como o código VS compartilhando o contexto do espaço de trabalho (arquivos, localização do cursor, seleções), permitindo que os fluxos de trabalho de assistência de código acionados por IA.

- Extensões e servidores MCP ajudam a integrar fluxos de trabalho personalizados diretamente no ambiente CLI ou IDE, melhorando a produtividade e a flexibilidade da cadeia de ferramentas.

do processo para adicionar ferramentas ou extensões personalizadas

1. Decida o escopo da ferramenta personalizada:
Determine se é um comando personalizado simples, um script ou um serviço externo totalmente de pleno direito.

2. Para comandos personalizados simples:
Crie `.toml` arquivos que definem comandos Slash e coloque -os na pasta de comandos apropriados.

3. Para serviços externos ou lógica complexa:
Desenvolva um servidor MCP usando o MCP SDK (suportando linguagens como Python ou TypeScript) que expõe os recursos da ferramenta por meio da API padronizada.

4. Configure o MCP Server em `Settings.json` ou Extension:
Adicione a entrada de configuração do servidor MCP (com comando ou URL) diretamente na configuração do usuário `~/.gemini/Settings.json` ou dentro de um arquivo` gemini-extenstension.json` em um diretório de extensão.

5. Opcionalmente agrupa -se em uma extensão:
Embale seus servidores MCP, comandos personalizados e arquivos de contexto em uma estrutura de diretório de extensão em `.gemini/extensões/`.

6. Iniciar ou reiniciar Gemini CLI:
A CLI Gemini carrega todas as configurações e servidores MCP na inicialização, ferramentas personalizadas de integração automática.

7. Use e verifique as ferramentas:
Use comandos como `/mcp` e`/mcp desc` para confirmar a disponibilidade da ferramenta e interagir com suas adições personalizadas.

benefícios desta arquitetura

- Modularidade: as ferramentas são executadas como servidores MCP separados, tornando o desenvolvimento independente e escalável.

- Integração dinâmica: as ferramentas aparecem automaticamente nos fluxos de trabalho da CLI Gemini sem codificação.

- Segurança e controle: as extensões podem limitar quais ferramentas ou comandos de shell são permitidos, impedindo o uso indevido.

- Reutilização: Pacote de extensões Fluxos de trabalho completos, compartilháveis ​​em projetos ou equipes.

- Comunidade e ecossistema: muitos servidores e extensões MCP estão disponíveis ou podem ser contribuídos, expandindo rapidamente os recursos de Gemini CLI.

Essa arquitetura permite que praticamente qualquer ferramenta, script ou serviço externo seja integrado ao ecossistema CLI Gemini, aumentando a produtividade e a personalização.

***

Esta resposta fornece uma explicação completa dos mecanismos de integração personalizada e de integração de extensão Gemini CLI, incluindo servidores MCP, embalagem de extensão, comandos personalizados e integração de script, atendendo ao comprimento e detalhes solicitados. Se desejado, mais detalhes sobre o uso do MCP SDK ou as configurações de exemplo podem ser fornecidas a seguir.