Brave-Gemini Research MCP Server

Brave-Gemini Research MCP 服务

一种现代化的 MCP（Model Context Protocol）服务实现，通过 Brave Search API 为 AI 助手提供网页搜索能力，并借助 Google 的 Gemini 模型进行高级研究论文分析。

概述

本项目让 Claude 等 AI 助手能够通过标准化的 API 接口直接执行网页搜索和分析研究论文。该 MCP 服务提供三种主要工具：

1. 网页搜索 — 用于常规互联网搜索和信息检索
2. 本地搜索 — 用于查找商家、地点和兴趣点
3. 研究论文分析 — 使用 Google 的 Gemini 模型深入分析学术论文

功能

• 🔍 网页搜索 API — 查找网络上的信息
• 🏢 本地搜索 API — 发现商家和地点
• 📑 研究论文分析 — 使用 Gemini AI 分析学术论文
• 🤖 Claude 集成 — 与 Claude Desktop 无缝连接
• 🛠️ 可扩展设计 — 轻松添加新工具和功能

设置与安装

前置条件

• 推荐使用 Node.js v18+
• Brave Search API 密钥（在此获取）
• 用于集成 Gemini 的 Google API 密钥（研究论文分析必需）
• 用于集成 AI 助手的 Claude Desktop（可选）

安装

1. 克隆代码仓库：

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

2. 安装依赖项：

   npm install
   

3. 创建 .env 文件并填入 API 密钥：

   BRAVE_API_KEY=your_brave_api_key
   GOOGLE_API_KEY=your_google_api_key
   

构建

将 TypeScript 代码编译为 JavaScript：

npm run build
# or manually
npx tsc

运行服务

设置环境变量并启动服务：

PowerShell：

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

命令提示符：

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 集成

按照以下步骤将 MCP 服务与 Claude Desktop 集成：

1. 确保已安装 Claude Desktop（在此下载）

2. 找到 Claude Desktop 配置文件：

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

3. 添加 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:*"
      }
    }
  }
}

4. 重要说明：

   • 在 args 和 cwd 字段中使用绝对路径；Windows 路径需使用双反斜杠
   • 将 G:\\path\\to\\your\\brave-gemini-research-mcp 替换为项目的实际路径
   • 将 your_brave_api_key 和 your_google_api_key 替换为实际的 API 密钥
   • timeoutMs 设置有助于避免初始化期间出现超时问题

5. 保存文件并重启 Claude Desktop

与 Claude 搭配使用

配置完成后，你可以通过以下提示词让 Claude 搜索网页或分析研究论文：

• “搜索网络上最新的 AI 研究论文”
• “查找旧金山的咖啡馆”
• “分析这篇关于量子计算的研究论文：[论文内容]”

Claude 将使用 MCP 服务执行这些搜索和分析，并直接在对话中返回结果。

工具能力

网页搜索工具

网页搜索工具可执行常规互联网搜索：

• 函数：brave_web_search
• 参数：
  • query（必需）：搜索查询（最多 400 个字符）
  • count（可选）：结果数量（1-20，默认值为 10）
  • offset（可选）：分页偏移量（最多为 9，默认值为 0）

本地搜索工具

本地搜索工具可查找商家和地点：

• 函数：brave_local_search
• 参数：
  • query（必需）：本地搜索查询（例如，“中央公园附近的披萨店”）
  • count（可选）：结果数量（1-20，默认值为 5）

研究论文分析工具

研究论文分析工具使用 Google 的 Gemini 模型对学术论文进行深入分析：

• 功能：gemini_research_paper_analysis
• 参数：
  • paperContent（必填）：要分析的研究论文全文
  • analysisType（可选）：要执行的分析类型
    • 选项："summary"、"critique"、"literature review"、"key findings"、"comprehensive"（默认）
  • additionalContext（可选）：用于指导分析的具体问题或上下文

分析类型：

• 摘要：全面概述研究问题、方法、主要发现和结论
• 批判：对方法、有效性、局限性进行批判性评估，并提出改进建议
• 文献综述：分析论文在更广泛研究领域中的定位
• 主要发现：提取并解释最重要的发现及其影响
• 全面分析：涵盖所有方面的完整分析（默认）

分析结果示例

使用 Gemini 的研究论文分析工具时，你会根据所选分析类型收到结构化的全面分析。例如，选择“全面分析”时，结果可能如下：

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

Gemini 模型可提供专家级分析，帮助研究人员、学生和专业人士快速理解和评估复杂的学术内容。

故障排除

常见问题

1. 找不到模块错误：

   • 确保 TypeScript 文件中的所有导入都包含 .js 扩展名
   • 修复导入后运行 npx tsc 重新编译
   • 检查生成的 dist 目录结构

2. 超时错误：

   • 增加 Claude Desktop 配置中的 timeoutMs（建议设为 120000 ms）
   • 检查环境变量是否已正确设置

3. API 密钥问题：

   • 确认环境中已正确设置 API 密钥
   • 检查是否受到速率限制或使用限制

4. Gemini 模型问题：

   • 确保你的 Google API 密钥有权访问 Gemini 模型
   • 检查论文内容是否超过令牌限制（尝试使用较短的摘录）
   • 确认分析类型属于受支持的选项之一

5. Windows 特定问题：

   • 使用 PowerShell，以便更可靠地处理环境变量
   • 在 JSON 配置中使用 Windows 路径时，请使用双反斜杠（例如：G:\\path\\to\\file）
   • 如果相对路径不起作用，可考虑使用绝对路径

调试

如需查看详细的调试输出：

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

测试设置

若要确认 MCP 服务是否正常运行：

1. 手动测试：

   • 使用上面的命令行说明运行服务
   • 检查控制台输出中是否出现“Brave-Gemini Research MCP Server running on stdio”
   • 不应出现错误消息

2. Claude Desktop 测试：

   • 配置 Claude Desktop 后，开启一段新对话
   • 请 Claude“搜索 AI 领域的最新进展”
   • Claude 应返回来自 Brave Search 的搜索结果
   • 请 Claude 分析一篇研究论文
   • Claude 应返回来自 Gemini 的详细分析

技术详情

MCP 协议

模型上下文协议允许 AI 模型通过标准化接口访问外部工具。主要组件包括：

• 工具：具有定义明确的架构的函数
• 传输：客户端与服务端之间的通信通道
• 处理器：用于处理请求并返回响应的逻辑

项目结构

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

引用

如果你在研究或项目中使用此工具，请按以下格式引用：

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

许可证

MIT

版权

© 2025 Falah G. Salieh，伊拉克巴格达。保留所有权利。

---

用 ❤️ 打造，助力增强 AI 能力