MCP Web Research Server

MCP ディープウェブリサーチサーバー (v0.3.0)

高度な Web 調査のためのモデル コンテキスト プロトコル (MCP) サーバー。

最新の変更点

• ウェブページコンテンツを直接抽出するための visit_page ツールを追加しました
• MCPタイムアウト制限内で動作するように最適化されたパフォーマンス
  • デフォルトのmaxDepthとmaxBranchingパラメータを削減
  • ページの読み込み効率の向上
  • プロセス全体にタイムアウトチェックを追加しました
  • タイムアウト時のエラー処理の強化

このプロジェクトは、 mzxraiによるmcp-webresearchのフォークであり、ディープウェブリサーチ機能のための追加機能が強化されています。私たちは、元の作成者たちの基礎的な作業に感謝いたします。

インテリジェントな検索キューイング、強化されたコンテンツ抽出、詳細な調査機能により、Claude にリアルタイムの情報を取り込みます。

特徴

• インテリジェント検索キューシステム
  • レート制限付きのバッチ検索操作
  • 進捗状況を追跡するキュー管理
  • エラー回復と自動再試行
  • 検索結果の重複排除
• 強化されたコンテンツ抽出
  • TF-IDFベースの関連性スコアリング
  • キーワード近接分析
  • コンテンツセクションの重み付け
  • 読みやすさスコア
  • HTML構造解析の改善
  • 構造化データ抽出
  • コンテンツの整理とフォーマットの改善
• コア機能
  • Google検索統合
  • ウェブページコンテンツの抽出
  • 研究セッションの追跡
  • フォーマットが改善されたマークダウン変換

前提条件

• Node.js >= 18 ( npmとnpxを含む)
• クロードデスクトップアプリ

インストール

グローバルインストール（推奨）

ローカルプロジェクトのインストール

クロードデスクトップ統合

パッケージをインストールした後、 claude_desktop_config.jsonに次のエントリを追加します。

ウィンドウズ

場所: %APPDATA%\Claude\claude_desktop_config.json

macOS

場所: ~/Library/Application Support/Claude/claude_desktop_config.json

この設定により、Claude Desktop は必要に応じて Web リサーチ MCP サーバーを自動的に起動できるようになります。

初回セットアップ

インストール後、このコマンドを実行して必要なブラウザ依存関係をインストールします。

使用法

Claude とチャットを開始し、Web リサーチに役立つプロンプトを送信するだけです。より詳細な Web リサーチ向けにカスタマイズされた既成のプロンプトが必要な場合は、このパッケージで提供されているagentic-researchプロンプトをご利用ください。Claude Desktop でこのプロンプトにアクセスするには、チャット入力欄のペーパークリップアイコンをクリックし、 Choose an integration → deepwebresearch → agentic-researchを選択します。

ツール

1. deep_research
   • コンテンツ分析による包括的な調査を実施
   • 引数:
     { topic: string; maxDepth?: number; // default: 2 maxBranching?: number; // default: 3 timeout?: number; // default: 55000 (55 seconds) minRelevanceScore?: number; // default: 0.7 }
   • 戻り値:
     { findings: { mainTopics: Array<{name: string, importance: number}>; keyInsights: Array<{text: string, confidence: number}>; sources: Array<{url: string, credibilityScore: number}>; }; progress: { completedSteps: number; totalSteps: number; processedUrls: number; }; timing: { started: string; completed?: string; duration?: number; operations?: { parallelSearch?: number; deduplication?: number; topResultsProcessing?: number; remainingResultsProcessing?: number; total?: number; }; }; }
2. parallel_search
   • インテリジェントなキューイングで複数の Google 検索を並行して実行します
   • 引数: { queries: string[], maxParallel?: number }
   • 注: 信頼性の高いパフォーマンスを確保するために、maxParallel は 5 に制限されています。
3. visit_page
   • ウェブページにアクセスしてコンテンツを抽出する
   • 引数: { url: string }
   • 戻り値:
     { url: string; title: string; content: string; // Markdown formatted content }

プロンプト

agentic-research

クロードが徹底的なウェブリサーチを行うのに役立つガイド付きリサーチプロンプト。このプロンプトは、クロードに以下の指示を与えます。

• トピックの状況を理解するために、まずは広範囲な検索から始めましょう
• 高品質で信頼できる情報源を優先する
• 調査結果に基づいて研究の方向性を繰り返し改善する
• 情報を提供し、インタラクティブに研究を進めることができます
• 常にURLでソースを引用する

設定オプション

サーバーは環境変数を通じて設定できます:

• MAX_PARALLEL_SEARCHES : 同時検索の最大数（デフォルト: 5）
• SEARCH_DELAY_MS : 検索間の遅延（ミリ秒単位）（デフォルト: 200）
• MAX_RETRIES : 失敗したリクエストの再試行回数（デフォルト: 3）
• TIMEOUT_MS : リクエストタイムアウト（ミリ秒）（デフォルト: 55000）
• LOG_LEVEL : ログレベル（デフォルト: 'info'）

エラー処理

よくある問題

1. レート制限
   • 症状: 「リクエストが多すぎます」というエラー
   • 解決策: SEARCH_DELAY_MSを増やすか、 MAX_PARALLEL_SEARCHESを減らす
2. ネットワークタイムアウト
   • 症状: 「リクエストがタイムアウトしました」というエラー
   • 解決策: リクエストが60秒のMCPタイムアウト内に完了することを確認する
3. ブラウザの問題
   • 症状: 「ブラウザの起動に失敗しました」というエラー
   • 解決策: Playwright が正しくインストールされていることを確認してください ( npx playwright install )

デバッグ

これはベータ版ソフトウェアです。問題が発生した場合は、以下の手順に従ってください。

1. Claude Desktop の MCP ログを確認します。
   # On macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # On Windows Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait
2. デバッグ ログを有効にする:
   export LOG_LEVEL=debug

発達

設定

テスト

コード品質

貢献

1. リポジトリをフォークする
2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
4. ブランチにプッシュする ( git push origin feature/amazing-feature )
5. プルリクエストを開く

コーディング標準

• TypeScriptのベストプラクティスに従う
• テストカバレッジを80%以上維持する
• 新しい機能とAPIを文書化する
• 重要な変更についてはCHANGELOG.mdを更新してください
• セマンティックバージョニングに従う

パフォーマンスに関する考慮事項

• 可能な場合はバッチ操作を使用する
• 適切なエラー処理と再試行を実装する
• 大規模なデータセットでのメモリ使用量を考慮する
• 適切な場合に結果をキャッシュする
• 大容量コンテンツにはストリーミングを使用する

要件

• Node.js >= 18
• Playwright (依存関係として自動的にインストールされます)

検証済みプラットフォーム

• [x] macOS
• [x] ウィンドウズ
• [ ] リナックス

ライセンス

マサチューセッツ工科大学

クレジット

このプロジェクトは、 mzxraiによるmcp-webresearchの優れた成果を基盤としています。オリジナルのコードベースは、私たちの強化された機能と性能の基盤となりました。

著者

qpd-v