Brave-Gemini Research MCP Server

Brave-Gemini Research MCP サーバー

Brave Search API によるウェブ検索機能と、Google の Gemini モデルによる高度な研究論文分析機能を AI アシスタントに提供する、最新の MCP（Model Context Protocol）サーバー実装です。

概要

このプロジェクトでは、Claude などの AI アシスタントが、標準化された API インターフェースを通じてウェブ検索や研究論文の分析を直接行えます。MCP サーバーは、次の 3 つの主要なツールを提供します。

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. API キーを記述した .env ファイルを作成します：

   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（任意）：分析の指針となる具体的な質問やコンテキスト

分析の種類：

• Summary：研究課題、方法論、主な知見、結論を含む包括的な概要
• Critique：方法論、妥当性、限界を批判的に評価し、改善案を提示します
• Literature Review：論文がより広範な研究分野の中でどのように位置付けられるかを分析します
• Key Findings：最も重要な知見とその示唆を抽出して説明します
• Comprehensive：あらゆる側面を網羅した完全な分析（デフォルト）

分析結果の例

Gemini を使って研究論文分析ツールを利用すると、選択した分析の種類に応じた、構成の整った包括的な分析が得られます。たとえば、「comprehensive」分析では、次のような結果が得られます。

## 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 プロトコル

Model Context Protocol を使用すると、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, Baghdad, Iraq. All rights reserved.

---

AI の機能向上のために ❤️ を込めて作成