Search Academic Papers from arXiv
mcp-scholarly exposes one MCP tool, search-arxiv, so AI assistants can search arXiv for accurate academic articles.
Why it matters
Access and retrieve precise academic papers from scientific sources like arXiv. This asset enables efficient searching and retrieval of scholarly content for research purposes.
Outcomes
What it gets done
Search for academic papers on arXiv using keywords.
Retrieve and process scholarly articles.
Integrate with scientific data providers.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-scholarly | bash Capabilities
Tools your agent gets
Search papers on arXiv by keyword
Overview
Scholarly MCP Server
mcp-scholarly is an MCP server with a single search-arxiv tool that searches arXiv by keyword, giving AI assistants real, citable academic articles instead of relying on unaided recall. Use it for literature review, fact-checking against published research, or surfacing recent arXiv preprints on a topic.
What it does
mcp-scholarly is an MCP server focused on finding accurate academic articles. In its current form it implements a single tool, search-arxiv, which takes a required keyword string argument and searches arXiv for articles related to that keyword, returning results an AI assistant can cite or summarize. The project states more scholarly vendors will be added over time, so arXiv is the first of what is meant to be a broader academic-search surface.
When to use - and when NOT to
Use this when an assistant needs to find real, citable academic papers on a topic - literature review, fact-checking a claim against published research, or surfacing recent preprints - rather than relying on an LLM's own possibly outdated or fabricated recollection of papers. It is not useful today for scholarly sources outside arXiv, since no other vendor integration is implemented yet, and it does not fetch full paper text or perform analysis - it returns search results for further use.
Inputs and outputs
The single search-arxiv tool accepts one required parameter, keyword, and returns matching arXiv articles for that search term.
Integrations
Installed via uv (either from source with a --directory pointing at the project, or via uvx mcp-scholarly for the published package) or via Docker (docker run --rm -i mcp/scholarly), and configured in Claude Desktop's claude_desktop_config.json under mcpServers. It can also be installed automatically via Smithery.
Who it's for
Researchers, students, and anyone building an AI assistant workflow that needs to ground answers in real arXiv papers rather than an LLM's unaided recall of academic literature. It is also useful during development or debugging of the server itself, since the project can be launched through the MCP Inspector for step-by-step request/response visibility, given that MCP servers communicate over stdio and are otherwise hard to observe directly.
npx -y @smithery/cli install mcp-scholarly --client claude
Source README
mcp-scholarly MCP server
A MCP server to search for accurate academic articles. More scholarly vendors will be added soon.
Components
Tools
The server implements one tool:
- search-arxiv: Search arxiv for articles related to the given keyword.
- Takes "keyword" as required string arguments
Quickstart
Install
Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Development/Unpublished Servers Configuration
``` "mcpServers": { "mcp-scholarly": { "command": "uv", "args": [ "--directory", "/Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly", "run", "mcp-scholarly" ] } } ```Published Servers Configuration
``` "mcpServers": { "mcp-scholarly": { "command": "uvx", "args": [ "mcp-scholarly" ] } } ```or if you are using Docker
Published Docker Servers Configuration
``` "mcpServers": { "mcp-scholarly": { "command": "docker", "args": [ "run", "--rm", "-i", "mcp/scholarly" ] } } ```Installing via Smithery
To install mcp-scholarly for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-scholarly --client claude
Development
Building and Publishing
To prepare the package for distribution:
- Sync dependencies and update lockfile:
uv sync
- Build package distributions:
uv build
This will create source and wheel distributions in the dist/ directory.
- Publish to PyPI:
uv publish
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:
--tokenorUV_PUBLISH_TOKEN - Or username/password:
--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging
experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via npm with this command:
npx @modelcontextprotocol/inspector uv --directory /Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly run mcp-scholarly
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
FAQ
Common questions
Discussion
Questions & comments ยท 0
Sign In Sign in to leave a comment.
