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.