Brave-Gemini-Research-MCP-Server

🚀 勇敢双子座研究MCP服务器

这是一个基于模型上下文协议（Model Context Protocol）构建的服务器，它允许AI模型借助外部工具来扩展自身功能。该服务器具备互联网搜索、计算器等实用功能，为AI模型的使用提供了更多便利。

🚀 快速开始

克隆仓库

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

安装依赖

npm install

启动服务器

node dist/index.js

配置Claude Desktop

1. 打开Claude Desktop的设置菜单。
2. 进入开发者工具选项。
3. 添加以下配置：

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

✨ 主要特性

勇敢搜索集成

• 支持互联网信息检索，可配合Brave Search API使用，为用户提供强大的网络信息搜索能力。

计算器工具

内置了一个功能强大的计算器，其相关接口定义如下：

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

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

📦 安装指南

克隆仓库

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

安装依赖

npm install

启动服务器

node dist/index.js

💻 使用示例

基础用法

在开发环境中启动时显示调试信息：

DEBUG=mcp:* npm start

高级用法

设置环境变量：

export NODE_ENV=development

📚 详细文档

启动日志

# 在开发环境中启动时显示调试信息
DEBUG=mcp:* npm start

# 设置环境变量
export NODE_ENV=development

故障排除

常见问题

1. 模块未找到错误：
   • 确保所有导入都包含.js扩展名。
   • 运行npx tsc重新编译。
2. 超时问题：
   • 增加超时设置。
   • 使用PowerShell处理环境变量。
3. API密钥问题：
   • 检查密钥是否正确配置。
   • 确保密钥未过期。

调试方法

# 显示详细调试日志
DEBUG=mcp:* npm start

测试验证

1. 手动测试：
   • 启动服务器，查看控制台输出是否显示启动信息。
   • 确保无错误提示。
2. Claude Desktop测试：
   • 新建对话框，输入搜索指令。
   • 验证返回结果是否正确。

🔧 技术细节

项目结构

├── dist/               # 编译后的JavaScript文件夹
├── src/
│   ├── config.ts       # 服务器配置文件
│   ├── server.ts       # MCP服务器实现
│   ├── calculator.ts   # 计算器工具模块
│   └── search.ts       # 勇敢搜索接口
└── package.json        # 项目依赖管理文件

📄 许可证

本项目遵循MIT License协议。

致谢

感谢以下项目的贡献：

• Brave Search：提供强大的网络检索能力。
• Node.js：稳定的运行环境。

版权信息

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