mcp-deep-research

🔍 McpDeepResearch

深い学術研究のための MCP（Model-Context-Protocol）サーバー

深い学術研究のための MCP サーバー

---

英語 | 簡体字中国語

---

英語

McpDeepResearch は、使い慣れた Google Scholar インターフェースを使って、ウェブ上の学術論文をすばやく見つけ、取得し、読むのに役立つ、軽量ながら強力な MCP（Model-Context-Protocol）サーバーです。

💡 ローカルブラウザーのセッションを再利用

このサーバーはページを直接取得せず、DevTools Protocol を通じてローカルにインストールされた Chrome を操作します。そのため、検索と取得はすべて、そのブラウザーですでに確立されているセッションを使って実行されます。ログイン状態が認識され、所属機関の文献データベースへのアクセス権（購読、学内ネットワークのライセンス）がそのまま再利用されるため、追加の認証情報やプロキシの設定は必要ありません。

✨ 機能

• search_scholar_papers – Google Scholar を検索します。年による絞り込みと日付順の並べ替えを指定できます
• fetch_md – 公開されている任意のウェブページを読みやすい Markdown に変換します
• fetch_paper – 論文の内容（タイトル、概要、本文、参考文献）を自動検出し、それ以外を除去します

🛠️ 前提条件

• Python ≥ 3.10
• Google Chrome/Chromium（Chrome DevTools Protocol を使ったヘッドレス取得用）
• 環境変数

  export CDP_ENDPOINT="http://localhost:9222"   # Chrome debugging port
  export GOOGLE_PROXY="http://proxy:port"        # (optional) HTTP(S) proxy
  

⚙️ クイックスタート

1. pip でインストール

   pip install mcp-deep-research
   

2. （任意）Chrome がまだ起動していない場合は手動で起動
   サーバーは Chrome インスタンスを自動的に起動します。起動に失敗した場合は、次のコマンドで手動で起動できます。

   google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile &
   

3. MCP サーバーを実行

   # Launch with SSE
   mcp-deep-research --transport sse --port 8000
   # Launch with STDIO
   mcp-deep-research --transport stdio
   

   サーバーは、MCP 対応クライアントに 3 つの読み取り専用ツールを公開します。

🧑‍🎓 チャット UI でのワークフロー例

1. 検索
   「2022 年以降の拡散モデルに関する最近の論文を探してください。」
   → search_scholar_papers("diffusion models", year=2022, sort_bd=True)

2. 取得
   検索結果から興味のある PDF リンクを選び、次を呼び出します。
   fetch_paper("https://arxiv.org/abs/2304.12345")

3. 閲覧
   整形された Markdown（タイトル、概要、全文）がチャットに直接表示されます。

🔒 セキュリティ

• 100％読み取り専用です。書き込み、アップロード、ローカルファイルへのアクセスはありません。
• すべての通信で、元のサイトの robots.txt が尊重されます。
• プロキシを設定して、所属機関または地域のファイアウォール内で利用できます。

🤝 コントリビューション

プルリクエストを歓迎します！

---

簡体字中国語

McpDeepResearch は軽量ながら高機能な MCP（Model-Context-Protocol）サーバーです。Google Scholar を使って、学術文献をすばやく見つけ、取得し、読むことができます。

💡 ローカルブラウザーのセッションを再利用

サーバーはウェブページに直接リクエストを送信せず、DevTools Protocol を通じてローカルにインストールされた Chrome を操作します。そのため、検索と取得のたびに、そのブラウザーですでに確立されているセッションが引き継がれます。ログイン状態が正しく認識され、所属機関の文献データベースへのアクセス権（購読、学内ネットワークのライセンスなど）をそのまま再利用できるため、追加の認証情報やプロキシの設定は不要です。

✨ 機能一覧

• search_scholar_papers – キーワードを使って Google Scholar を検索します。年による絞り込みや日付順の並べ替えが可能です
• fetch_md – 公開されている任意のウェブページを読みやすい Markdown に変換します
• fetch_paper – ウェブページから論文の本文を自動抽出し、広告やナビゲーションバーなどのノイズを除去します

🛠️ 前提条件

• Python ≥ 3.10
• Google Chrome / Chromium（CDP を使ったヘッドレス取得用）
• 環境変数

  export CDP_ENDPOINT="http://localhost:9222"   # Chrome 调试端口
  export GOOGLE_PROXY="http://proxy:port"        # 可选：HTTP(S) 代理
  

⚙️ クイックスタート

1. pip でインストール

   pip install mcp-deep-research
   

2. （任意）Chrome がまだ起動していない場合は手動で起動
   サーバーの起動時に Chrome インスタンスが自動的に起動します。正常に起動しなかった場合は、手動で起動できます。

   google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile &
   

3. MCP サーバーを起動

   # 以 SSE 启动
   mcp-deep-research --transport sse --port 8000
   # 以 STDIO 启动
   mcp-deep-research --transport stdio
   

   サーバーは 3 つの読み取り専用ツールを公開します。

🧑‍🎓 チャット UI での典型的なワークフロー

1. 検索
   「2022 年以降の拡散モデルに関する論文を探してください。」
   → search_scholar_papers("diffusion models", year=2022, sort_bd=True)

2. 取得
   検索結果から PDF リンクを 1 つ選び、次を呼び出します。
   fetch_paper("https://arxiv.org/abs/2304.12345")

3. 閲覧
   整形された Markdown（タイトル、概要、全文）がチャットウィンドウに直接表示されます。

🔒 セキュリティ

• 完全な読み取り専用です。変更、アップロード、ローカルファイルへの書き込みは行いません。
• すべてのリクエストで、対象サイトの robots.txt が尊重されます。
• 学内ネットワークや企業ネットワークのセキュリティポリシーに合わせてプロキシを設定できます。

🤝 コントリビューション

プルリクエストを歓迎します！

---