Brave-Gemini Research MCP Server

A modern MCP (Model Context Protocol) server implementation that provides AI assistants with web search capabilities via the Brave Search API and advanced research paper analysis with Google's Gemini model.

Overview

This project enables AI assistants like Claude to perform web searches and analyze research papers directly through a standardized API interface. The MCP server exposes three main tools:

Web Search - For general internet searches and information retrieval
Local Search - For finding businesses, locations, and places of interest
Research Paper Analysis - For in-depth analysis of academic papers using Google's Gemini model

Features

🔍 Web Search API - Find information across the web
🏢 Local Search API - Discover businesses and places
📑 Research Paper Analysis - Analyze academic papers with Gemini AI
🤖 Claude Integration - Seamless connection with Claude Desktop
🛠️ Extensible Design - Easy to add new tools and capabilities

Setup and Installation

Prerequisites

Node.js v18+ recommended
Brave Search API key (Get one here)
Google API key for Gemini integration (required for research paper analysis)
Claude Desktop for AI assistant integration (optional)

Installation

Clone the repository:

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

Install dependencies:
```
npm install
```

Create a .env file with your API keys:

BRAVE_API_KEY=your_brave_api_key
GOOGLE_API_KEY=your_google_api_key

Building

Compile the TypeScript code to JavaScript:

npm run build
# or manually
npx tsc

Running the Server

Set environment variables and start the server:

PowerShell:

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

Command Prompt:

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

Claude Desktop Integration

Follow these steps to integrate the MCP server with Claude Desktop:

Ensure you have Claude Desktop installed (Download here)
Locate your Claude Desktop configuration file:
- Windows: C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Add the Brave-Gemini Research MCP configuration:

{
  "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:*"
      }
    }
  }
}

Important notes:
- Use absolute paths with double backslashes (Windows) in the args and cwd fields
- Replace G:\\path\\to\\your\\brave-gemini-research-mcp with the actual path to your project
- Replace your_brave_api_key and your_google_api_key with your actual API keys
- The timeoutMs setting helps prevent timeout issues during initialization
Save the file and restart Claude Desktop

Using with Claude

After configuration, you can ask Claude to search the web or analyze research papers with prompts like:

"Search the web for the latest AI research papers"
"Find coffee shops in San Francisco"
"Analyze this research paper on quantum computing: [paper content]"

Claude will use the MCP server to perform these searches and analyses, returning the results directly in your conversation.

Tool Capabilities

Web Search Tool

The web search tool enables general internet searches:

Function: brave_web_search
Parameters:
- query (required): Search query (max 400 chars)
- count (optional): Number of results (1-20, default 10)
- offset (optional): Pagination offset (max 9, default 0)

Local Search Tool

The local search tool finds businesses and locations:

Function: brave_local_search
Parameters:
- query (required): Local search query (e.g., "pizza near Central Park")
- count (optional): Number of results (1-20, default 5)

Research Paper Analysis Tool

The research paper analysis tool provides in-depth analysis of academic papers using Google's Gemini model:

Function: gemini_research_paper_analysis
Parameters:
- paperContent (required): The full text of the research paper to analyze
- analysisType (optional): Type of analysis to perform
  - Options: "summary", "critique", "literature review", "key findings", "comprehensive" (default)
- additionalContext (optional): Specific questions or context to guide the analysis

Analysis Types:

Summary: Comprehensive overview including research question, methodology, key findings, and conclusions
Critique: Critical evaluation of methodology, validity, limitations, and suggestions for improvement
Literature Review: Analysis of how the paper fits within the broader research landscape
Key Findings: Extraction and explanation of the most significant findings and implications
Comprehensive: Complete analysis covering all aspects (default)

Example Analysis Result

When using the Research Paper Analysis tool with Gemini, you'll receive a structured, comprehensive analysis depending on the analysis type selected. For example, with a "comprehensive" analysis, you might get:

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

The Gemini model provides expert-level analysis that helps researchers, students, and professionals quickly understand and evaluate complex academic content.

Troubleshooting

Common Issues

Module Not Found Errors:
- Ensure all imports include .js extensions in TypeScript files
- Run npx tsc to recompile after fixing imports
- Check the generated dist directory structure
Timeout Errors:
- Increase the timeoutMs in Claude Desktop configuration (120000 ms recommended)
- Check that environment variables are properly set
API Key Issues:
- Verify your API keys are correctly set in the environment
- Check for rate limiting or usage restrictions
Gemini Model Issues:
- Ensure your Google API key has access to Gemini models
- Check if the paper content exceeds token limits (try shorter excerpts)
- Verify the analysis type is one of the supported options
Windows-Specific Issues:
- Use PowerShell for more reliable environment variable handling
- For Windows paths in JSON config, use double backslashes (e.g., G:\\path\\to\\file)
- Consider using absolute paths if relative paths aren't working

Debugging

For detailed debugging output:

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

Testing Your Setup

To verify your MCP server is working correctly:

Manual Test:
- Run the server using the command line instructions above
- Check the console output for "Brave-Gemini Research MCP Server running on stdio"
- No error messages should appear
Claude Desktop Test:
- After configuring Claude Desktop, open a new conversation
- Ask Claude to "Search for latest developments in AI"
- Claude should respond with search results from Brave Search
- Ask Claude to analyze a research paper
- Claude should respond with a detailed analysis from Gemini

Technical Details

MCP Protocol

The Model Context Protocol allows AI models to access external tools through a standardized interface. Key components include:

Tools: Functions with defined schemas
Transports: Communication channels between clients and servers
Handlers: Logic to process requests and return responses

Project Structure

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

Citation

If you use this tool in your research or project, please cite it as:

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

License

MIT

Copyright

Made with ❤️ for enhancing AI capabilities