mcp-deep-research

Pb-207/mcp-deep-research

3.1
deep_research

If you are the rightful owner of mcp-deep-research and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

mcp-deep-research is an mcp server designed for local-deployed deep research.

🔍 McpDeepResearch

An MCP (Model-Context-Protocol) Server for Deep Academic Research

一个用于深度学术研究的 MCP 服务器

English | 简体中文

English

McpDeepResearch is a lightweight but powerful MCP (Model-Context-Protocol) server that helps you quickly discover, retrieve, and read academic papers from the web using the familiar Google Scholar interface.

✨ Features

  • search_scholar_papers – Google Scholar search with optional year-filter & date-sort
  • fetch_md – Convert any public web page to clean Markdown
  • fetch_paper – Auto-detect the paper content (title, abstract, body, references) and strip the rest

🛠️ Prerequisites

  • Python ≥ 3.10
  • Google Chrome/Chromium (for headless fetching via Chrome DevTools Protocol)
  • Environment variables 
    export CDP_ENDPOINT="http://localhost:9222"   # Chrome debugging port
export GOOGLE_PROXY="http://proxy:port"        # (optional) HTTP(S) proxy

⚙️ Quick Start

  1. Install via pip

    pip install

  2. (Optional) Manually launch Chrome if it isn’t already running
    The server will automatically launch a Chrome instance; if not successfully launched, you can launch it manually with:

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

  3. Run the MCP server

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

    The server exposes 3 read-only tools to any MCP-capable client.

🧑‍🎓 Example Workflow in a Chat-UI

  1. Search
    “Find recent papers on diffusion models after 2022.”
    → search_scholar_papers("diffusion models", year=2022, sort_bd=True)

  2. Fetch
    Pick an interesting PDF link from the results and call
    fetch_paper("https://arxiv.org/abs/2304.12345")

  3. Read
    The cleaned Markdown (title, abstract, full text) appears directly in the chat.

🔒 Security

  • 100 % read-only; no writes, no uploads, no local file access.
  • All traffic respects the original site’s robots.txt.
  • Proxies can be configured to stay within institutional or regional firewalls.

🤝 Contributing

PRs are welcome!

简体中文

McpDeepResearch 是一个轻量级、但功能完备的 MCP（Model-Context-Protocol）服务器，帮助你在 Google Scholar 上快速发现、抓取并阅读学术文献。

✨ 功能一览

  • 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

  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 个只读工具。

🧑‍🎓 对话界面中的典型工作流

  1. 搜索
    “找 2022 年之后关于扩散模型的论文。”
    → search_scholar_papers("diffusion models", year=2022, sort_bd=True)

  2. 抓取
    从结果中挑选一篇 PDF 链接，调用
    fetch_paper("https://arxiv.org/abs/2304.12345")

  3. 阅读
    清洗后的 Markdown（含标题、摘要、全文）直接展示在聊天窗口。

🔒 安全性

  • 完全只读，不修改、不上传、不写入本地文件。
  • 所有请求均尊重目标站点的 robots.txt。
  • 可配置代理以符合校园网或公司网络的安全策略。

🤝 如何贡献

欢迎提 PR！