Scholar MCP
Federated academic search, citation graphs, PDF download and paper reading for agents
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.11.0
- Listing updated
- 4 days ago
Similar MCP servers
About Scholar MCP
Scholar MCP is an MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.
One question fans out to many scholarly indexes at once, including OpenAlex, Semantic Scholar, arXiv, Crossref, PubMed, Europe PMC, DBLP, CORE and Google Scholar. Duplicates merge on DOI, arXiv id or title, a ranking model orders the pool, and citations of the strongest matches are pulled in before the final ranking.
Beyond search it reads a paper page by page into Markdown with tables and figure images, downloads PDFs from open archives or your institution's library, builds citation graphs with PageRank, and keeps a local SQLite library with notes and tags that can mirror to Obsidian, Zotero or Notion.
The README reports a 62% top-five hit rate on 50 LitSearch queries versus 52% for Exa and 46% for BM25. An installer registers it with 32 agent clients. Several indexes accept optional API keys.
Install
Run in a terminal
claude mcp add scholar-mcp --env S2_API_KEY='<S2_API_KEY>' --env OPENALEX_API_KEY='<OPENALEX_API_KEY>' --env CORE_API_KEY='<CORE_API_KEY>' --env SCOPUS_API_KEY='<SCOPUS_API_KEY>' --env DASHSCOPE_API_KEY='<DASHSCOPE_API_KEY>' --env SCHOLAR_RERANK_API_KEY='<SCHOLAR_RERANK_API_KEY>' --env EXA_API_KEY='<EXA_API_KEY>' --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' --env NOTION_API_KEY='<NOTION_API_KEY>' -- uvx scholar-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"scholar-mcp": {
"command": "uvx",
"args": [
"scholar-mcp"
],
"env": {
"S2_API_KEY": "<S2_API_KEY>",
"OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
"CORE_API_KEY": "<CORE_API_KEY>",
"SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
"DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
"SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
"EXA_API_KEY": "<EXA_API_KEY>",
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"scholar-mcp": {
"command": "uvx",
"args": [
"scholar-mcp"
],
"env": {
"S2_API_KEY": "<S2_API_KEY>",
"OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
"CORE_API_KEY": "<CORE_API_KEY>",
"SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
"DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
"SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
"EXA_API_KEY": "<EXA_API_KEY>",
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"scholar-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"scholar-mcp"
],
"env": {
"S2_API_KEY": "<S2_API_KEY>",
"OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
"CORE_API_KEY": "<CORE_API_KEY>",
"SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
"DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
"SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
"EXA_API_KEY": "<EXA_API_KEY>",
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"scholar-mcp": {
"command": "uvx",
"args": [
"scholar-mcp"
],
"env": {
"S2_API_KEY": "<S2_API_KEY>",
"OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
"CORE_API_KEY": "<CORE_API_KEY>",
"SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
"DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
"SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
"EXA_API_KEY": "<EXA_API_KEY>",
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"scholar-mcp": {
"command": "uvx",
"args": [
"scholar-mcp"
],
"env": {
"S2_API_KEY": "<S2_API_KEY>",
"OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
"CORE_API_KEY": "<CORE_API_KEY>",
"SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
"DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
"SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
"EXA_API_KEY": "<EXA_API_KEY>",
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SCHOLAR_DATA_DIRSCHOLAR_MCP_EXTENSIONSS2_API_KEYOPENALEX_API_KEYCORE_API_KEYSCOPUS_API_KEYDASHSCOPE_API_KEYDASHSCOPE_HTTP_BASE_URLAlibaba workspace API host or /api/v1 base URL.SCHOLAR_RERANK_MODELAlibaba or custom reranker model name.SCHOLAR_RERANK_URLFull custom rerank endpoint; overrides Alibaba routing.SCHOLAR_RERANK_API_KEYEXA_API_KEYZOTERO_API_KEYZOTERO_LIBRARY_IDNOTION_API_KEYNOTION_DATA_SOURCE_ID
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- search_papers
- Searches all sources, merges duplicates and reranks.
- paper_info
- Metadata, citations and references of a paper.
- recommend_papers
- Semantic neighbours and co-cited papers.
- search_authors
- Author profiles, affiliations and metrics.
- read_paper
- Page-aware Markdown, tables and figures, read temporarily.
- download_paper
- Downloads the PDF into your library.
- build_paper_graph
- Citation graph with PageRank and bridge papers.
- paper_library
- Collections, notes, tags and full-text search.
What it does
- Parallel multi-source search
- Queries many indexes at once; a slow source cannot stall the rest.
- Citation traversal
- Follows citations and related work for the best matches.
- Paper reading
- Page-aware Markdown with tables and figure images.
- Persistent library
- SQLite store with notes, tags and full-text search.
- PDF download
- Fetches open copies or via your library proxy.
- One-line installer
- Registers itself with supported agent clients.
Good for
- Survey recent work on a research topic
- Trace a paper's citations and references
- Read a paper's tables and figures
- Build a personal reading library with notes
- Find the right author behind a common name
Scholar MCP FAQ
Which sources does it search?
The README names OpenAlex, Semantic Scholar, arXiv, Crossref, OpenReview, PubMed, Europe PMC, DBLP, zbMATH, CORE, OpenAIRE and Google Scholar.
Do I need API keys?
Keys for Semantic Scholar, OpenAlex, CORE and Scopus are optional extras.
Where does it store data?
In a local library under ~/.scholar-mcp/.
How was retrieval quality measured?
On the first 50 LitSearch inline-ACL queries, per the README.
How do I add Scholar MCP to Claude Code?
Run this command in your terminal: claude mcp add scholar-mcp --env S2_API_KEY='<S2_API_KEY>' --env OPENALEX_API_KEY='<OPENALEX_API_KEY>' --env CORE_API_KEY='<CORE_API_KEY>' --env SCOPUS_API_KEY='<SCOPUS_API_KEY>' --env DASHSCOPE_API_KEY='<DASHSCOPE_API_KEY>' --env SCHOLAR_RERANK_API_KEY='<SCHOLAR_RERANK_API_KEY>' --env EXA_API_KEY='<EXA_API_KEY>' --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' --env NOTION_API_KEY='<NOTION_API_KEY>' -- uvx scholar-mcp
What are the best alternatives to Scholar MCP?
The closest alternatives to Scholar MCP are Machine Library, Academic Research MCP Server, Cerebrum, arXiv & OpenAlex Academic Search MCP and Papers by Ouroboros Apps.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.