Brave-Gemini Research MCP Server

Realiza búsquedas web con la API de Brave Search y analiza documentos de investigación utilizando el modelo Gemini de Google.

GitHub
7
Prueba este MCPPatrocinado

Documentación

Brave-Gemini Research MCP Server

Una implementación moderna de servidor MCP (Model Context Protocol) que proporciona a los asistentes de IA capacidades de búsqueda web a través de la API de Brave Search y análisis avanzado de artículos de investigación con el modelo Gemini de Google.

Descripción General

Este proyecto permite a asistentes de IA como Claude realizar búsquedas web y analizar artículos de investigación directamente a través de una interfaz API estandarizada. El servidor MCP expone tres herramientas principales:

  1. Búsqueda Web - Para búsquedas generales en internet y recuperación de información
  2. Búsqueda Local - Para encontrar negocios, ubicaciones y lugares de interés
  3. Análisis de Artículos de Investigación - Para el análisis en profundidad de artículos académicos utilizando el modelo Gemini de Google

Características

  • 🔍 API de Búsqueda Web - Encuentra información en toda la web
  • 🏢 API de Búsqueda Local - Descubre negocios y lugares
  • 📑 Análisis de Artículos de Investigación - Analiza artículos académicos con IA Gemini
  • 🤖 Integración con Claude - Conexión perfecta con Claude Desktop
  • 🛠️ Diseño Extensible - Fácil de añadir nuevas herramientas y capacidades

Configuración e Instalación

Requisitos Previos

  • Se recomienda Node.js v18+
  • Clave de API de Brave Search (Obtén una aquí)
  • Clave de API de Google para la integración con Gemini (requerida para el análisis de artículos de investigación)
  • Claude Desktop para la integración con el asistente de IA (opcional)

Instalación

  1. Clona el repositorio:

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

  2. Instala las dependencias:

    npm install

  3. Crea un archivo .env con tus claves de API:

    BRAVE_API_KEY=your_brave_api_key
GOOGLE_API_KEY=your_google_api_key

Compilación

Compila el código TypeScript a JavaScript:

npm run build
# or manually
npx tsc

Ejecutando el Servidor

Configura las variables de entorno e inicia el servidor:

PowerShell:

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

Símbolo del sistema:

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

Integración con Claude Desktop

Sigue estos pasos para integrar el servidor MCP con Claude Desktop:

  1. Asegúrate de tener Claude Desktop instalado (Descárgalo aquí)

  2. Localiza tu archivo de configuración de Claude Desktop:

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

  3. Añade la configuración de 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:

    • Usa rutas absolutas con dobles barras invertidas (Windows) en los campos args y cwd
    • Reemplaza G:\\path\\to\\your\\brave-gemini-research-mcp con la ruta real de tu proyecto
    • Reemplaza your_brave_api_key y your_google_api_key con tus claves de API reales
    • El ajuste timeoutMs ayuda a prevenir problemas de tiempo de espera durante la inicialización

  2. Guarda el archivo y reinicia Claude Desktop

Uso con Claude

Después de la configuración, puedes pedirle a Claude que busque en la web o analice artículos de investigación con indicaciones como:

  • "Busca en la web los artículos de investigación de IA más recientes"
  • "Encuentra cafeterías en San Francisco"
  • "Analiza este artículo de investigación sobre computación cuántica: [contenido del artículo]"

Claude utilizará el servidor MCP para realizar estas búsquedas y análisis, devolviendo los resultados directamente en tu conversación.

Capacidades de las Herramientas

Herramienta de Búsqueda Web

La herramienta de búsqueda web permite búsquedas generales en internet:

  • Función: brave_web_search
  • Parámetros:
    • query (obligatorio): Consulta de búsqueda (máx. 400 caracteres)
    • count (opcional): Número de resultados (1-20, por defecto 10)
    • offset (opcional): Desplazamiento de paginación (máx. 9, por defecto 0)

Herramienta de Búsqueda Local

La herramienta de búsqueda local encuentra negocios y ubicaciones:

  • Función: brave_local_search
  • Parámetros:
    • query (obligatorio): Consulta de búsqueda local (p. ej., "pizza cerca de Central Park")
    • count (opcional): Número de resultados (1-20, por defecto 5)

Herramienta de Análisis de Artículos de Investigación

La herramienta de análisis de artículos de investigación proporciona un análisis en profundidad de artículos académicos utilizando el modelo Gemini de Google:

  • Función: gemini_research_paper_analysis
  • Parámetros:
    • paperContent (obligatorio): El texto completo del artículo de investigación a analizar
    • analysisType (opcional): Tipo de análisis a realizar
      • Opciones: "summary", "critique", "literature review", "key findings", "comprehensive" (por defecto)
    • additionalContext (opcional): Preguntas específicas o contexto para guiar el análisis

Tipos de Análisis:

  • Resumen: Visión general completa que incluye la pregunta de investigación, la metodología, los hallazgos clave y las conclusiones
  • Crítica: Evaluación crítica de la metodología, validez, limitaciones y sugerencias de mejora
  • Revisión de Literatura: Análisis de cómo el artículo encaja en el panorama de investigación más amplio
  • Hallazgos Clave: Extracción y explicación de los hallazgos e implicaciones más significativos
  • Completo: Análisis completo que cubre todos los aspectos (por defecto)

Ejemplo de Resultado de Análisis

Al utilizar la herramienta de Análisis de Artículos de Investigación con Gemini, recibirás un análisis estructurado y completo según el tipo de análisis seleccionado. Por ejemplo, con un análisis "completo", podrías obtener:

## 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]

El modelo Gemini proporciona un análisis a nivel experto que ayuda a investigadores, estudiantes y profesionales a comprender y evaluar rápidamente contenido académico complejo.

Solución de Problemas

Problemas Comunes

  1. Errores de Módulo No Encontrado:

    • Asegúrate de que todas las importaciones incluyan extensiones .js en los archivos TypeScript
    • Ejecuta npx tsc para recompilar después de corregir las importaciones
    • Verifica la estructura del directorio dist generado

  2. Errores de Tiempo de Espera:

    • Aumenta el timeoutMs en la configuración de Claude Desktop (se recomiendan 120000 ms)
    • Verifica que las variables de entorno estén configuradas correctamente

  3. Problemas con las Claves de API:

    • Verifica que tus claves de API estén configuradas correctamente en el entorno
    • Comprueba si hay limitaciones de velocidad o restricciones de uso

  4. Problemas con el Modelo Gemini:

    • Asegúrate de que tu clave de API de Google tenga acceso a los modelos Gemini
    • Comprueba si el contenido del artículo supera los límites de tokens (prueba con extractos más cortos)
    • Verifica que el tipo de análisis sea una de las opciones compatibles

  5. Problemas Específicos de Windows:

    • Usa PowerShell para un manejo más fiable de las variables de entorno
    • Para rutas de Windows en la configuración JSON, usa dobles barras invertidas (p. ej., G:\\path\\to\\file)
    • Considera usar rutas absolutas si las rutas relativas no funcionan

Depuración

Para obtener una salida de depuración detallada:

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

Probando tu Configuración

Para verificar que tu servidor MCP funciona correctamente:

  1. Prueba Manual:

    • Ejecuta el servidor usando las instrucciones de línea de comandos anteriores
    • Comprueba la salida de la consola para ver "Brave-Gemini Research MCP Server running on stdio"
    • No deberían aparecer mensajes de error

  2. Prueba con Claude Desktop:

    • Después de configurar Claude Desktop, abre una nueva conversación
    • Pídele a Claude que "busque los últimos avances en IA"
    • Claude debería responder con resultados de búsqueda de Brave Search
    • Pídele a Claude que analice un artículo de investigación
    • Claude debería responder con un análisis detallado de Gemini

Detalles Técnicos

Protocolo MCP

El Protocolo de Contexto de Modelo (Model Context Protocol) permite a los modelos de IA acceder a herramientas externas a través de una interfaz estandarizada. Los componentes clave incluyen:

  • Herramientas: Funciones con esquemas definidos
  • Transportes: Canales de comunicación entre clientes y servidores
  • Manejadores: Lógica para procesar solicitudes y devolver respuestas

Estructura del Proyecto

├── 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

Si utilizas esta herramienta en tu investigación o proyecto, por favor cítala 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

Licencia

MIT

Derechos de Autor

© 2025 Falah G. Salieh, Baghdad, Iraq. Todos los derechos reservados.

Hecho con ❤️ para mejorar las capacidades de IA