Gemini MCP Server

Acesse a IA Gemini do Google através da ferramenta de linha de comando gemini-cli.

Documentação

Gemini MCP Server

Um servidor Model Context Protocol (MCP) que fornece recursos de pesquisa na internet com tecnologia de IA por meio da ferramenta gemini-cli.

Visão Geral

Este servidor MCP permite que o Claude e outros assistentes de IA realizem pesquisas na internet em tempo real, interagindo com a ferramenta de linha de comando gemini-cli. Ele fornece uma única ferramenta query que pode pesquisar informações atuais e fornecer análise com tecnologia de IA.

Recursos

  • Pesquisa em Tempo Real: Consulte dados atuais da internet por meio de pesquisa com tecnologia de IA
  • Protocolo MCP: Implementa o Model Context Protocol para integração perfeita
  • Streaming HTTP: Usa transporte de streaming HTTP para comunicação eficiente
  • TypeScript: Totalmente tipado com TypeScript para confiabilidade
  • Desligamento Gracioso: Lida com sinais SIGINT/SIGTERM para saídas limpas

Pré-requisitos

  • Node.js 18+
  • gemini-cli instalado e configurado no seu sistema
  • TypeScript (para desenvolvimento)

Instalação

  1. Clone o repositório:
git clone <repository-url>
cd gemini-mcp
  1. Instale as dependências:
npm install
  1. Compile o projeto:
npm run build

Uso

Modo de Desenvolvimento

npm run dev

Modo de Produção

npm start

O servidor iniciará na porta 13001 por padrão, ou você pode definir uma porta personalizada:

PORT=8080 npm start

Configuração

Variáveis de Ambiente

  • PORT: Porta do servidor (padrão: 13001)

Ferramenta MCP

O servidor fornece uma ferramenta:

query

  • Descrição: Envie uma consulta a um agente de IA que pode pesquisar dados da internet em tempo real
  • Parâmetros:
    • text (string): A consulta de pesquisa ou pergunta a ser enviada ao agente de IA
  • Retorna: Resposta gerada por IA com informações atuais

Integração

Com o Claude Desktop

Adicione à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "gemini-search": {
      "command": "node",
      "args": ["path/to/gemini-mcp/dist/index.js"],
      "env": {
        "PORT": "13001"
      }
    }
  }
}

Com Outros Clientes MCP

Conecte-se ao endpoint de streaming HTTP:

http://localhost:13001

Desenvolvimento

Scripts

  • npm run build - Compila TypeScript para JavaScript
  • npm run start - Executa o servidor compilado
  • npm run dev - Executa em modo de desenvolvimento com ts-node

Estrutura do Projeto

src/
├── index.ts          # Main server implementation
├── package.json      # Project configuration
└── dist/            # Compiled JavaScript (after build)

Dependências

  • fastmcp: Framework de servidor MCP
  • zod: Validação de esquema
  • child_process: Integrado do Node.js para iniciar processos

Licença

MIT

Contribuição

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça suas alterações
  4. Teste minuciosamente
  5. Envie um pull request