Brave Gemini Research MCP Server

🚀 Brave Gemini Research MCP Server

This is a server built on the Model Context Protocol (MCP), enabling AI models to extend their capabilities through external tools. The server supports the following features:

🚀 Quick Start

📦 Installation

Clone the repository

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

Install dependencies

npm install

Start the server

node dist/index.js

💻 Configuration for Claude Desktop

1. Open the settings menu in Claude Desktop.
2. Navigate to the developer tools option.
3. Add the following configuration:

{
  "MCP": {
    "enabled": true,
    "servers": [
      {
        "name": "Brave-Gemini Research Server",
        "uri": "stdio",
        "timeout": 30000,
        "context": {}
      }
    ]
  }
}

✨ Features

🔍 Brave Search Integration

• Supports internet information retrieval.
• Works with the Brave Search API.

🧮 Calculator Tool

interface CalculateOptions {
  expression: string;
  precision?: number;
}

interface CalculateResult {
  success: boolean;
  result?: number;
  error?: string;
}

📜 Startup Log

# Show debug information when starting in the development environment
DEBUG=mcp:* npm start

# Set environment variables
export NODE_ENV=development

🛠️ Troubleshooting

🤔 Common Issues

1. Module not found error:
   • Ensure all imports include the .js extension.
   • Run npx tsc to recompile.
2. Timeout issues:
   • Increase the timeout settings.
   • Use PowerShell to handle environment variables.
3. API key issues:
   • Check if the key is correctly configured.
   • Ensure the key has not expired.

🐞 Debugging Methods

# Show detailed debug logs
DEBUG=mcp:* npm start

🧪 Testing and Verification

🖐️ Manual Testing

• Start the server and check if the console output shows startup information.
• Ensure there are no error messages.

📋 Claude Desktop Testing

• Create a new dialog and enter a search command.
• Verify if the returned results are correct.

🔧 Technical Details

📁 Project Structure

├── dist/               # Compiled JavaScript folder
├── src/
│   ├── config.ts       # Server configuration file
│   ├── server.ts       # MCP server implementation
│   ├── calculator.ts   # Calculator tool module
│   └── search.ts       # Brave Search interface
└── package.json        # Project dependency management file

🙏 Acknowledgments

Thanks to the following projects for their contributions:

• Brave Search: Provides powerful web retrieval capabilities.
• Node.js: A stable runtime environment.

📄 License

This project is licensed under the MIT License.

©️ Copyright Information

copyright (c) 2024 Your Name. All rights reserved.