convez.ai
MCP ServerBusca & PesquisaAvançado
zhdzh12138

Scholar Search — Busca Unificada de Artigos Acadêmicos

zhdzh12138/scholar-search

Busca unificada IEEE + ScienceDirect + CNKI com autenticação institucional

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server que integra busca e download de artigos científicos de IEEE Xplore, ScienceDirect e CNKI (知网) através de uma conexão Chrome via CDP. Suporta autenticação institucional (CARSI) com persistência automática de cookies, eliminando a necessidade de login repetido.

Instalação

$npx convez-ai zhdzh12138/scholar-search

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
40
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Pesquisadores buscando artigos em português, inglês e chinês de forma centralizada
  • Estudantes acadêmicos baixando PDFs de bases restritas via acesso institucional
  • Automação de coleta de literatura científica em fluxos de pesquisa

Veredito

Solução robusta e bem arquitetada para pesquisa acadêmica em ambiente corporativo/institucional. Requer setup local (Chrome + Python) e credenciais de instituição. Ideal para pesquisadores que precisam de automação cross-database com autenticação real.

README

A tradução para o português deste README ainda está na fila.

Scholar Search — 学术论文搜索下载 MCP

通过 CDP 连接用户真实 Chrome,一站式搜索和下载 IEEE / ScienceDirect / CNKI 论文。

无需自动化登录 — 用户手动登录一次,cookie 自动保存恢复。

chrome --remote-debugging-port=9222     ← 自动启动(如未运行)
       ↓
CDP 连接 (carsi_search/engine.py)      ← cookie 保存/恢复
       ↓
┌──────────┬───────────┬──────────┐
│   IEEE   │Elsevier   │   CNKI   │
│  CARSI   │  CARSI    │   CDP    │
└──────────┴───────────┴──────────┘

安装

git clone https://github.com/zhdzh12138/scholar-search.git ~/scholar-search
cd ~/scholar-search
pip install playwright mcp
python -m playwright install chromium

注册 MCP(全局配置,使用绝对路径):

claude mcp add cnki-ieee-download -- python ~/scholar-search/cnki-ieee-download/server.py

或编辑 .mcp.json(参考 .mcp.json.example):

{
  "mcpServers": {
    "cnki-ieee-download": {
      "command": "python",
      "args": ["C:/Users/你的用户名/scholar-search/cnki-ieee-download/server.py"],
      "allowInteractive": true
    }
  }
}

allowInteractive: true 允许 MCP server 在需要用户操作时(如登录、过验证码)向 Claude 发送交互提示。

MCP 工具

工具说明
ieee_login连接 Chrome,检测 IEEE 登录状态
ieee_search搜索 IEEE 论文
ieee_detail获取 IEEE 论文详情
ieee_download下载 IEEE PDF
sciencedirect_login连接 Chrome,检测 ScienceDirect 登录状态
sciencedirect_search搜索 ScienceDirect 论文
sciencedirect_detail获取 ScienceDirect 论文详情
sciencedirect_download下载 ScienceDirect PDF(可能需手动过 Cloudflare)
cnki_search搜索 CNKI(自动连接 Chrome)
cnki_login检测 CNKI 登录状态
cnki_detail获取 CNKI 论文详情
cnki_download下载 CNKI PDF/CAJ
status显示 CDP 连接状态和各数据库登录状态
logout断开 CDP(不关闭 Chrome)

首次使用

  1. 打开 Claude Code
  2. 首次调用 MCP 工具时自动启动 Chrome(带 --remote-debugging-port=9222)
  3. 在 Chrome 窗口中手动登录:
    • CNKI:点击"机构登录" → 校外访问 → 选择学校
    • IEEE:点击"Institutional Sign In" → CARSI → 学校认证
    • ScienceDirect:点击"Institutional Sign In" → CARSI → 学校认证
  4. Cookie 自动保存 — 后续启动无需重新登录
  5. 未登录时 Claude 会提示你在 Chrome 中登录
  6. PDF 下载到调用项目的 downloads/ 目录

功能覆盖

功能数据源实现
英文学术论文搜索IEEE XploreCDP + CARSI cookie
IEEE PDF 下载IEEE XploreCDP + CARSI cookie + JS fetch
英文学术论文搜索/详情ScienceDirectCDP + CARSI cookie
ScienceDirect PDF 下载ScienceDirectCDP + CARSI cookie(Cloudflare 可能需手动验证)
中文学术论文搜索/详情CNKI 知网CDP 连接真实 Chrome
CNKI PDF/CAJ 下载CNKI 知网CDP + expect_download

项目结构

scholar-search/
├── cnki-ieee-download/             # MCP 服务器
│   ├── server.py                   # 入口 + 工具定义 + handler 函数
│   └── carsi_search/               # CDP 引擎 + 数据库适配器
├── downloads/                      # PDF 下载目录
├── .mcp.json.example               # MCP 配置模板
└── README.md

依赖

组件必需用途
Claude Code是MCP 宿主
Chrome是(自动启动)CDP 连接真实浏览器
Playwright + mcp是MCP 服务器运行时
机构账号下载需要IEEE/ScienceDirect CARSI 认证;CNKI 机构登录

免责声明

  • 本项目仅在西安电子科技大学账号下测试通过,其他学校的 CARSI 认证流程、域名、IdP 配置可能不同,需要对 carsi_search/registry.py 中的 sp_url、home_url、target_url_pattern 等字段进行修改。
  • 本项目仅供学术研究使用,请遵守各数据库的使用条款。
  • Cookie 文件(.carsi_state.json)包含登录凭证,请勿提交到公开仓库。

致谢

License

MIT

Ver o original no GitHub

Bom para

Relacionados