topper-mcp
Provides academic paper retrieval via the Semantic Scholar API, enabling searches for top-tier research papers and returning their metadata and links.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
用一段话描述你要找的研究,返回这个方向上的顶会顶刊论文。
它做了什么
一个研究问题
→ LLM 写检索简报 (query families + 领域自己的术语)
→ 多轮检索 (Semantic Scholar + OpenAlex,合并去重)
→ 档次门 (CCF / 中科院分区 / JCR / WoS / 旗舰刊名单)
→ 相关性门 (主题契合度,光有声望进不来)
→ 打分 + 全景 (学派、活跃团队)Related MCP server: Semantic Scholar MCP Server
安装
pip install "topper-mcp[mcp]" # 含 MCP 服务
pip install topper-mcp # 只要库和命令行(引擎零依赖,纯标准库)
cp .env.example .env # 只有两项必填,见下
topper doctor # 它会逐条告诉你还缺什么配置
必填两项,topper doctor 会检查并点名缺失的那一项。
变量 | 必填 | 说明 |
| 是 | 任何 OpenAI 兼容端点——OpenAI、本地 vLLM/Ollama 网关、中转都行 |
| 是 | 例如 |
| 否 | 默认 |
| 否 | 逗号分隔,主模型不可用时依次尝试 |
| 否 | 不填也能跑,但会被限流到几秒一次。免费申请 |
| 否 | OpenAlex 的礼貌策略;不填就走慢速公共池 |
| 否 | 档次表的位置,见 |
当 MCP 服务用
{
"mcpServers": {
"topper": {
"command": "topper-mcp",
"env": {
"TOPPER_LLM_API_KEY": "sk-...",
"TOPPER_LLM_MODEL": "gpt-4o-mini",
"SEMANTIC_SCHOLAR_API_KEY": "..."
}
}
}
}三个工具:
工具 | 作用 |
| 检索 |
| 查一个期刊或会议的档次标签 |
| 只生成检索计划,不打数据源 |
当命令行用
topper search "钙钛矿太阳能电池的稳定性衰减机理与界面钝化策略"
topper plan "双重差分 多期处理 异质性" # 只出检索计划,不打数据源
topper tiers "Journal of Econometrics"当库用
from topper import search, SearchPolicy
hits = search(
"graph neural networks",
policy=SearchPolicy(ccf_levels=("A", "B"), cas_zones=(1, 2), max_age_years=5),
limit=20,
)覆盖范围
开箱可用
名录 | 数量 | 等级分布 | 默认门 |
CCF 推荐目录 2026 | 670(会议 383 / 期刊 287) | A 87 · B 234 · C 349 | 只放 A/B |
旗舰刊名单(人工整理) | 38 | — | 全放 |
CCF 十大方向的 A 类代表
方向 | A 类代表 |
人工智能 | NeurIPS、ICML、CVPR、ICCV、ACL、AAAI、IJCAI 等 |
数据库 / 数据挖掘 / 内容检索 | SIGMOD、VLDB、ICDE、KDD、SIGIR |
软件工程 / 系统软件 / 程序设计语言 | ICSE、FSE、OSDI、SOSP、POPL、PLDI、ASE 等 |
计算机体系结构 / 并行与分布计算 | ISCA、ASPLOS、MICRO、HPCA、SC、FAST、EuroSys 等 |
计算机网络 | SIGCOMM、MobiCom、INFOCOM、NSDI |
网络与信息安全 | CCS、S&P、USENIX Security、NDSS、CRYPTO 等 |
计算机科学理论 | STOC、FOCS、SODA、CAV、LICS |
计算机图形学与多媒体 | SIGGRAPH、ACM MM、IEEE VIS、IEEE VR |
人机交互与普适计算 | CHI、CSCW、UbiComp |
交叉 / 综合 / 新兴 | WWW、RTSS |
旗舰刊 38 本
学科 | 刊 |
综合 | Nature、Science、Cell、Nature Communications、Science Advances、PNAS |
医学 | NEJM、The Lancet、JAMA、BMJ、Nature Medicine |
生命科学 | Nature Methods / Biotechnology / Genetics / Neuroscience、Immunity、Cancer Cell、Molecular Cell、Neuron |
物理 化学 材料 | PRL、JACS、Angewandte Chemie、Advanced Materials、Nature Materials / Physics / Chemistry、Chem、Joule |
经济 社科 | AER、Econometrica、QJE、JPE、REStud、Journal of Econometrics、Psychological Bulletin / Review、ASR、APSR |
需要自己装
引擎能读,但这些名录各有使用条款,本仓不做再分发。放进 topper/data/(或
TOPPER_DATA_DIR 指向的目录)即可生效,格式见
topper/data/README.md。缺表不影响运行,topper doctor
会报告哪几张没装。
名录 | 学科数 | 等级 |
中科院分区 | 21 | 1–4 区 |
JCR | 254 | Q1–Q4 |
SCI / SSCI / A&HCI | — | 是否收录 |
FMS 经管期刊评级 | 33 | A/B/C/D/T1/T2 |
另外两件要知道的
只返回元数据和链接,不抓取付费全文。
一次检索是一次 LLM 调用加若干次数据源往返,通常 30–120 秒。检索简报会缓存到磁盘, 同一个问题再问一次快得多。
开发
pip install -e ".[dev,mcp]"
pytest -q许可
代码是 MIT。
两处例外:
名录数据保留各自的条款,见
topper/data/README.md品牌资产(
assets/目录、TOPPER 名称与标识)不在 MIT 授权范围内。代码随意 fork,请用你自己的名字和标识发布
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.
Academic paper search, scientific literature, citation analysis, arXiv & semantic related-work.
Search 340M+ academic papers — citation graphs, semantic similarity, and AI literature reviews.
Research paper search with real citations and reference formatting for AI assistants
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to search, analyze, and summarize academic research papers in real-time from arXiv, Semantic Scholar, and PubMed. Provides automatic deduplication, citation analysis, and BibTeX generation across multiple research databases.26 npmMIT
- AlicenseAqualityBmaintenanceProvides direct access to 200M+ academic papers from Semantic Scholar, enabling paper search with advanced filters, author discovery, citation analysis, and AI-powered paper recommendations through natural language.1425MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive academic research through the Semantic Scholar API, including paper search, author discovery, citation network analysis, and full-text access from arXiv and Wiley sources.25 npm29ISC
- AlicenseNot gradedqualityBmaintenanceEnables searching academic papers, exploring citation graphs, and discovering related research via ArXiv and Semantic Scholar APIs.MIT