勇敢双子研究MCP服务器

Name: 勇敢双子研究MCP服务器
Author: falahgs

作者：falahgs5 星标更新：2025-04-13

安装使用来源：spider==github.com

项目介绍

Brave-Gemini 研究 MCP 服务器

一个现代的 MCP（模型上下文协议）服务器实现，通过 Brave 搜索 API 提供网络搜索功能，并使用 Google 的 Gemini 模型进行高级研究论文分析。

概述

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

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

特性

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

设置和安装

先决条件

推荐Node.js v18+
Brave搜索API密钥（在这里获取）
用于Gemini集成的Google API密钥（研究论文分析所需）
Claude桌面（用于AI助手集成，可选）

安装

克隆仓库：

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

安装依赖项：
```
npm install
```

创建包含您的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桌面集成

按照以下步骤将MCP服务器与Claude桌面集成：

确保已安装Claude桌面（下载链接）
找到您的Claude桌面配置文件：
- Windows: C:\Users\<用户名>\AppData\Roaming\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
添加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:*"
      }
    }
  }
}

注意事项：
- 使用绝对路径并在args和cwd字段中使用双反斜杠（Windows）
- 将G:\\path\\to\\your\\brave-gemini-research-mcp替换为您项目的实际路径
- 将your_brave_api_key和your_google_api_key替换为您的实际API密钥
- timeoutMs设置有助于防止初始化时出现超时问题
保存文件并重启Claude桌面

使用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模型提供了专家级别的分析，帮助研究人员、学生和专业人士快速理解并评估复杂的学术内容。

故障排除

常见问题

模块未找到错误：
- 确保所有导入在TypeScript文件中包含.js扩展名
- 修复导入后运行npx tsc重新编译
- 检查生成的dist目录结构
超时错误：
- 在Claude桌面配置中增加timeoutMs（推荐120000毫秒）
- 检查环境变量是否正确设置
API密钥问题：
- 验证您的API密钥在环境中正确设置
- 检查是否有速率限制或使用限制
Gemini模型问题：
- 确保您的Google API密钥具有访问Gemini模型的权限
- 检查论文内容是否超过令牌限制（尝试较短的摘录）
- 验证分析类型是支持的选项之一
Windows特定问题：
- 使用PowerShell以更可靠地处理环境变量
- 对于JSON配置中的Windows路径，使用双反斜杠（如：G:\\path\\to\\file）
- 如果相对路径不起作用，请考虑使用绝对路径

调试

为了获得详细的调试输出：

# 设置环境变量
DEBUG=mcp:* NODE_ENV=development node dist/index.js

测试您的设置

验证您的MCP服务器是否正常工作：

手动测试：
- 使用上述命令行指令运行服务器
- 检查控制台输出是否显示"Brave-Gemini Research MCP Server正在stdio上运行"
- 不应出现任何错误消息
Claude桌面测试：
- 配置Claude桌面后，打开新的对话
- 要求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: 一种用于AI助手搜索网络和分析研究论文的工具。
https://github.com/yourusername/brave-gemini-research-mcp

许可证

MIT

版权

用心制作，提升AI能力