Brave-Gemini Research MCP Server

Realize pesquisas na web com a API Brave Search e analise artigos de pesquisa usando o modelo Gemini do Google.

GitHub
7
Experimente este MCPPatrocinado

Documentação

Brave-Gemini Research MCP Server

Uma implementação moderna de servidor MCP (Model Context Protocol) que fornece aos assistentes de IA recursos de pesquisa na web por meio da Brave Search API e análise avançada de artigos de pesquisa com o modelo Gemini do Google.

Visão Geral

Este projeto permite que assistentes de IA como o Claude realizem pesquisas na web e analisem artigos de pesquisa diretamente por meio de uma interface de API padronizada. O servidor MCP expõe três ferramentas principais:

  1. Pesquisa na Web - Para buscas gerais na internet e recuperação de informações
  2. Pesquisa Local - Para encontrar empresas, locais e pontos de interesse
  3. Análise de Artigos de Pesquisa - Para análise aprofundada de artigos acadêmicos usando o modelo Gemini do Google

Recursos

  • 🔍 API de Pesquisa na Web - Encontre informações na web
  • 🏢 API de Pesquisa Local - Descubra empresas e locais
  • 📑 Análise de Artigos de Pesquisa - Analise artigos acadêmicos com IA Gemini
  • 🤖 Integração com Claude - Conexão perfeita com o Claude Desktop
  • 🛠️ Design Extensível - Fácil adicionar novas ferramentas e recursos

Configuração e Instalação

Pré-requisitos

  • Node.js v18+ recomendado
  • Chave da API Brave Search (Obtenha uma aqui)
  • Chave da API Google para integração com Gemini (necessária para análise de artigos de pesquisa)
  • Claude Desktop para integração com assistente de IA (opcional)

Instalação

  1. Clone o repositório:

    git clone https://github.com/falahgs/brave-gemini-research-mcp.git
cd brave-gemini-research-mcp

  2. Instale as dependências:

    npm install

  3. Crie um arquivo .env com suas chaves de API:

    BRAVE_API_KEY=your_brave_api_key
GOOGLE_API_KEY=your_google_api_key

Compilação

Compile o código TypeScript para JavaScript:

npm run build
# or manually
npx tsc

Executando o Servidor

Defina as variáveis de ambiente e inicie o servidor:

PowerShell:

$env:BRAVE_API_KEY="your_brave_api_key"
$env:GOOGLE_API_KEY="your_google_api_key"
node dist/index.js

Prompt de Comando:

SET BRAVE_API_KEY=your_brave_api_key
SET GOOGLE_API_KEY=your_google_api_key
node dist/index.js

Bash/Linux/macOS:

BRAVE_API_KEY=your_brave_api_key GOOGLE_API_KEY=your_google_api_key node dist/index.js

Integração com Claude Desktop

Siga estes passos para integrar o servidor MCP ao Claude Desktop:

  1. Certifique-se de ter o Claude Desktop instalado (Baixe aqui)

  2. Localize o arquivo de configuração do Claude Desktop:

    • Windows: C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  3. Adicione a configuração do Brave-Gemini Research MCP:

{
  "mcpServers": {
    "Brave-Gemini Research": {
      "command": "node",
      "args": ["G:\\path\\to\\your\\brave-gemini-research-mcp\\dist\\index.js"],
      "cwd": "G:\\path\\to\\your\\brave-gemini-research-mcp",
      "timeoutMs": 120000,
      "env": {
        "BRAVE_API_KEY": "your_brave_api_key",
        "GOOGLE_API_KEY": "your_google_api_key",
        "NODE_ENV": "production",
        "DEBUG": "mcp:*"
      }
    }
  }
}

  1. Notas importantes:

    • Use caminhos absolutos com barras invertidas duplas (Windows) nos campos args e cwd
    • Substitua G:\\path\\to\\your\\brave-gemini-research-mcp pelo caminho real do seu projeto
    • Substitua your_brave_api_key e your_google_api_key pelas suas chaves de API reais
    • A configuração timeoutMs ajuda a evitar problemas de tempo limite durante a inicialização

  2. Salve o arquivo e reinicie o Claude Desktop

Usando com o Claude

Após a configuração, você pode pedir ao Claude para pesquisar na web ou analisar artigos de pesquisa com comandos como:

  • "Pesquise na web os artigos de pesquisa de IA mais recentes"
  • "Encontre cafeterias em São Francisco"
  • "Analise este artigo de pesquisa sobre computação quântica: [conteúdo do artigo]"

O Claude usará o servidor MCP para realizar essas pesquisas e análises, retornando os resultados diretamente na sua conversa.

Recursos das Ferramentas

Ferramenta de Pesquisa na Web

A ferramenta de pesquisa na web permite buscas gerais na internet:

  • Função: brave_web_search
  • Parâmetros:
    • query (obrigatório): Consulta de pesquisa (máx. 400 caracteres)
    • count (opcional): Número de resultados (1-20, padrão 10)
    • offset (opcional): Deslocamento de paginação (máx. 9, padrão 0)

Ferramenta de Pesquisa Local

A ferramenta de pesquisa local encontra empresas e locais:

  • Função: brave_local_search
  • Parâmetros:
    • query (obrigatório): Consulta de pesquisa local (ex.: "pizza perto do Central Park")
    • count (opcional): Número de resultados (1-20, padrão 5)

Ferramenta de Análise de Artigos de Pesquisa

A ferramenta de análise de artigos de pesquisa fornece análise aprofundada de artigos acadêmicos usando o modelo Gemini do Google:

  • Função: gemini_research_paper_analysis
  • Parâmetros:
    • paperContent (obrigatório): O texto completo do artigo de pesquisa a ser analisado
    • analysisType (opcional): Tipo de análise a ser realizada
      • Opções: "summary", "critique", "literature review", "key findings", "comprehensive" (padrão)
    • additionalContext (opcional): Perguntas específicas ou contexto para orientar a análise

Tipos de Análise:

  • Resumo: Visão geral abrangente incluindo questão de pesquisa, metodologia, principais descobertas e conclusões
  • Crítica: Avaliação crítica da metodologia, validade, limitações e sugestões de melhoria
  • Revisão de Literatura: Análise de como o artigo se encaixa no panorama mais amplo da pesquisa
  • Principais Descobertas: Extração e explicação das descobertas e implicações mais significativas
  • Abrangente: Análise completa cobrindo todos os aspectos (padrão)

Exemplo de Resultado de Análise

Ao usar a ferramenta de Análise de Artigos de Pesquisa com o Gemini, você receberá uma análise estruturada e abrangente, dependendo do tipo de análise selecionado. Por exemplo, com uma análise "abrangente", você pode obter:

## Research Paper Analysis: Comprehensive

### Overview
[Summary of paper's main topic and research objectives]

### Methodology Assessment
[Evaluation of the research methods and design]

### Key Findings
[Breakdown of the most significant discoveries and results]

### Limitations
[Analysis of constraints and weaknesses in the research]

### Significance & Implications
[Discussion of the paper's importance to the field]

### Recommendations
[Suggestions for future research or applications]

O modelo Gemini fornece análise em nível de especialista que ajuda pesquisadores, estudantes e profissionais a entender e avaliar rapidamente conteúdo acadêmico complexo.

Solução de Problemas

Problemas Comuns

  1. Erros de Módulo Não Encontrado:

    • Certifique-se de que todas as importações incluam extensões .js nos arquivos TypeScript
    • Execute npx tsc para recompilar após corrigir as importações
    • Verifique a estrutura do diretório dist gerado

  2. Erros de Tempo Limite:

    • Aumente o timeoutMs na configuração do Claude Desktop (120000 ms recomendado)
    • Verifique se as variáveis de ambiente estão definidas corretamente

  3. Problemas com Chaves de API:

    • Verifique se suas chaves de API estão definidas corretamente no ambiente
    • Verifique se há limitação de taxa ou restrições de uso

  4. Problemas com o Modelo Gemini:

    • Certifique-se de que sua chave da API Google tenha acesso aos modelos Gemini
    • Verifique se o conteúdo do artigo excede os limites de tokens (tente trechos mais curtos)
    • Verifique se o tipo de análise é uma das opções suportadas

  5. Problemas Específicos do Windows:

    • Use PowerShell para manipulação mais confiável de variáveis de ambiente
    • Para caminhos do Windows na configuração JSON, use barras invertidas duplas (ex.: G:\\path\\to\\file)
    • Considere usar caminhos absolutos se os caminhos relativos não estiverem funcionando

Depuração

Para saída detalhada de depuração:

# Set environment variables
DEBUG=mcp:* NODE_ENV=development node dist/index.js

Testando Sua Configuração

Para verificar se seu servidor MCP está funcionando corretamente:

  1. Teste Manual:

    • Execute o servidor usando as instruções de linha de comando acima
    • Verifique a saída do console para "Brave-Gemini Research MCP Server running on stdio"
    • Nenhuma mensagem de erro deve aparecer

  2. Teste com Claude Desktop:

    • Após configurar o Claude Desktop, abra uma nova conversa
    • Peça ao Claude para "Pesquisar os últimos desenvolvimentos em IA"
    • O Claude deve responder com resultados de pesquisa do Brave Search
    • Peça ao Claude para analisar um artigo de pesquisa
    • O Claude deve responder com uma análise detalhada do Gemini

Detalhes Técnicos

Protocolo MCP

O Model Context Protocol permite que modelos de IA acessem ferramentas externas por meio de uma interface padronizada. Os principais componentes incluem:

  • Ferramentas: Funções com esquemas definidos
  • Transportes: Canais de comunicação entre clientes e servidores
  • Manipuladores: Lógica para processar solicitações e retornar respostas

Estrutura do Projeto

├── dist/               # Compiled JavaScript files
├── src/
│   ├── config.ts       # Server configuration
│   ├── server.ts       # MCP server implementation
│   ├── tools/          # Tool definitions and handlers
│   └── utils/          # Utility functions and API clients
├── index.ts            # Server entry point
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project dependencies

Citação

Se você usar esta ferramenta em sua pesquisa ou projeto, cite-a como:

Salieh, F. G. (2025). Brave-Gemini Research MCP Server: A tool for AI assistants to search the web and analyze research papers. 
https://github.com/yourusername/brave-gemini-research-mcp

Licença

MIT

Direitos Autorais

© 2025 Falah G. Salieh, Bagdá, Iraque. Todos os direitos reservados.

Feito com ❤️ para aprimorar as capacidades de IA