You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+10-16Lines changed: 10 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# Scholar Search MCP
2
2
3
-
A MCP server that integrates the [CORE API v3](https://api.core.ac.uk/docs/v3), [Semantic Scholar API](https://www.semanticscholar.org/product/api), and [arXiv API](https://info.arxiv.org/help/api/user-manual.html) so AI assistants (e.g. Claude, Cursor) can search and fetch academic paper metadata.
3
+
A MCP server that integrates the [Semantic Scholar API](https://www.semanticscholar.org/product/api) and [arXiv API](https://info.arxiv.org/help/api/user-manual.html) so AI assistants (e.g. Claude, Cursor) can search and fetch academic paper metadata.
4
4
5
5
## Features
6
6
7
-
-**Search papers** – Keyword search with **fallback chain**: tries**CORE API** first (no key required; set `CORE_API_KEY` for higher limits), then **Semantic Scholar**, then**arXiv**; optional year and venue filters (venue applies to Semantic Scholar only)
7
+
-**Search papers** – Keyword search with parallel merge from**Semantic Scholar** and**arXiv**; optional year and venue filters (venue applies to Semantic Scholar only)
8
8
-**Paper details** – Full metadata (title, authors, abstract, citations, etc.)
9
9
-**Citations & references** – Papers that cite or are cited by a given paper
@@ -71,22 +68,20 @@ Add an MCP server in Cursor settings with the same `command`, `args`, and `env`
71
68
72
69
### API keys (optional)
73
70
74
-
**Search fallback order:** When you call `search_papers`, the server tries sources in order and uses the first that succeeds:
71
+
`search_papers` queries enabled sources in parallel and merges results by title:
75
72
76
-
1.**CORE API** – Tried first; works without a key (subject to [rate limits](https://api.core.ac.uk/docs/v3#section/Rate-limits)). Set `CORE_API_KEY` for higher limits ([register](https://core.ac.uk/api-keys/register)).
77
-
2.**Semantic Scholar** – Used if CORE fails; works without a key with lower limits. Set `SEMANTIC_SCHOLAR_API_KEY` for higher limits.
78
-
3.**arXiv** – Used as last fallback; no key required.
73
+
1.**Semantic Scholar** – Works without a key with lower limits. Set `SEMANTIC_SCHOLAR_API_KEY` for higher limits.
74
+
2.**arXiv** – No key required.
79
75
80
76
### Enable/disable search channels
81
77
82
-
Control which sources are used in the `search_papers` fallback chain via environment variables (default: all enabled):
78
+
Control which sources are used in `search_papers` via environment variables (default: all enabled):
0 commit comments