Brave-Gemini 研究 MCP 服务器

一个现代的 MCP (模型上下文协议) 服务器实现，通过 Brave 搜索 API 为 AI 助手提供网络搜索功能，并通过 Google 的 Gemini 模型提供高级研究论文分析。

概述

该项目使像 Claude 这样的 AI 助手能够通过标准化的 API 接口直接执行网络搜索和分析研究论文。 MCP 服务器公开了三个主要工具：

1. 网络搜索 - 用于一般互联网搜索和信息检索
2. 本地搜索 - 用于查找企业、地点和感兴趣的地方
3. 研究论文分析 - 使用 Google 的 Gemini 模型对学术论文进行深入分析

特性

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

设置和安装

前提条件

• 推荐 Node.js v18+
• Brave 搜索 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. 创建一个包含您的 API 密钥的 .env 文件：

   BRAVE_API_KEY=your_brave_api_key
   GOOGLE_API_KEY=your_google_api_key
   

构建

将 TypeScript 代码编译为 JavaScript：

npm run build
# 或手动
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 研究 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 的研究论文分析工具时，您将收到一个结构化的、全面的分析，具体取决于所选的分析类型。 例如，对于“综合”分析，您可能会得到：

## 研究论文分析：综合

### 概述
[论文主要主题和研究目标的摘要]

### 方法评估
[研究方法和设计的评估]

### 主要发现
[最重要发现和结果的分解]

### 局限性
[研究中约束和弱点的分析]

### 意义与影响
[讨论论文对该领域的重要性]

### 建议
[对未来研究或应用的建议]

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

故障排除

常见问题

1. 找不到模块错误:

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

2. 超时错误:

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

3. API 密钥问题:

   • 验证您的 API 密钥是否已在环境中正确设置
   • 检查是否存在速率限制或使用限制

4. Gemini 模型问题:

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

5. Windows 特定问题:

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

调试

对于详细的调试输出：

# 设置环境变量
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 搜索的搜索结果
   • 要求 Claude 分析一篇研究论文
   • Claude 应该回复来自 Gemini 的详细分析

技术细节

MCP 协议

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

• 工具: 具有定义模式的函数
• 传输: 客户端和服务器之间的通信通道
• 处理程序: 处理请求和返回响应的逻辑

项目结构

├── dist/               # 编译后的 JavaScript 文件
├── src/
│   ├── config.ts       # 服务器配置
│   ├── server.ts       # MCP 服务器实现
│   ├── tools/          # 工具定义和处理程序
│   └── utils/          # 实用程序函数和 API 客户端
├── index.ts            # 服务器入口点
├── tsconfig.json       # TypeScript 配置
└── package.json        # 项目依赖

引用

如果您在您的研究或项目中使用此工具，请引用它为：

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 功能