Gemini

Fornece acesso às capacidades de IA do Google Gemini como ferramentas.

Documentação

Servidor MCP Gemini

Um servidor Model Context Protocol (MCP) que fornece capacidades de IA do Google Gemini como ferramentas. Construído com Deno e TypeScript.

Recursos

ask_gemini: Assistente de IA unificado alimentado pelo Gemini 3 Pro com Pesquisa Google integrada e capacidades de análise de URLs

Pré-requisitos

Deno (v1.40+)
Chave da API Google Gemini (Obtenha uma aqui)

Instalação

Opção 1: Usar Pacote JSR (Recomendado)

A maneira mais fácil é usar o pacote JSR publicado diretamente na sua configuração do Claude Desktop:

# No installation needed! Use jsr:@cong/gemini-mcp directly in your Claude config

Opção 2: A partir do Código Fonte

Clone este repositório:

git clone <repository-url>
cd gemini-mcp

Defina suas variáveis de ambiente:

export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview

Uso

Iniciar o Servidor

# Set your environment variables first
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview

# Development mode (with watch)
deno task dev

# Production mode
deno task start

Testando com o MCP Inspector

Para testar o servidor com o MCP Inspector, certifique-se de que suas variáveis de ambiente estejam definidas:

# Set environment variables in your shell
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview

# Install MCP Inspector if you haven't already
npm install -g @modelcontextprotocol/inspector

# Run the inspector
npx @modelcontextprotocol/inspector src/server.ts

Importante: As variáveis de ambiente devem ser definidas no mesmo shell onde você executa o MCP Inspector.

Executar Testes

# Run all tests
deno task test

# Run tests with watch mode
deno task test:watch

Qualidade do Código

# Format code
deno fmt

# Lint code
deno lint

Ferramenta MCP

ask_gemini

O assistente de IA unificado alimentado pelo Gemini 3 Pro com Pesquisa Google integrada e capacidades de análise de URLs.

Parâmetros:

prompt (obrigatório): Sua pergunta ou solicitação. Inclua URLs diretamente no texto para análise.

Exemplo:

{
  "name": "ask_gemini",
  "arguments": {
    "prompt": "What are the latest developments in quantum computing? Please analyze this paper: https://arxiv.org/abs/2301.01234"
  }
}

Capacidades:

🔍 Pesquisa automaticamente na web por informações atuais
📄 Analisa URLs mencionadas no texto do seu prompt
🧠 Usa o Gemini 3 Pro com capacidades de raciocínio, ferramentas urlContext e googleSearch
📚 Fornece respostas abrangentes e bem fundamentadas com raciocínio aprimorado

Dependências

@modelcontextprotocol/sdk - SDK MCP TypeScript
@google/generative-ai - Cliente da API Google Gemini
zod - Validação de tipos em tempo de execução
@std/assert - Asserções da biblioteca padrão do Deno

Desenvolvimento

Este projeto usa Deno com TypeScript. Comandos-chave de desenvolvimento:

deno task dev - Iniciar servidor de desenvolvimento com modo de observação
deno task test - Executar suíte de testes
deno cache src/server.ts - Armazenar dependências em cache
deno fmt - Formatar código
deno lint - Verificar lint do código

Solução de Problemas

Problemas com Variáveis de Ambiente

Se você receber erros de variáveis de ambiente:

Verifique se suas variáveis de ambiente estão definidas:
```
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

Para testes com o MCP Inspector, certifique-se de que ambas as variáveis estejam definidas no mesmo terminal:

export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview
npx @modelcontextprotocol/inspector src/server.ts

Verifique os logs do servidor: Quando o servidor inicia, ele mostrará (API Key: configured) para confirmar que sua chave foi carregada.

Suporte

Configuração do Claude Desktop

Para usar este servidor MCP com o Claude Desktop, adicione-o à sua configuração do Claude:

macOS/Linux/Windows

Edite seu arquivo de configuração do Claude:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gemini": {
      "command": "deno",
      "args": [
        "run",
        "--allow-net",
        "--allow-env",
        "jsr:@cong/gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "gemini-3-pro-preview"
      }
    }
  }
}

Desenvolvimento Local

Se você estiver executando a partir do código fonte:

{
  "mcpServers": {
    "gemini": {
      "command": "deno",
      "args": [
        "run",
        "--allow-net",
        "--allow-env",
        "src/server.ts"
      ],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "gemini-3-pro-preview"
      }
    }
  }
}

Contribuindo

Faça um fork do repositório
Crie um branch de funcionalidade
Faça suas alterações
Execute os testes: deno task test
Formate o código: deno fmt
Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.