Scholarly (arXiv)

by adityak74

88 stars
220 downloads
Not rated
GitHub

About

Integrates with arXiv to enable keyword-based searching and retrieval of academic articles for research assistance and literature reviews.

Details

Author
adityak74
Repository
adityak74/mcp-scholarly
GitHub stars
88
Downloads
220
License
MIT License
Categories
Search, Other, AI, Design, Developer Tools, Infrastructure, Frontend

- Search arxiv for academic articles by keyword.
- Single tool with a required keyword argument.
- Installable via Claude Desktop, Docker, or Smithery.
- Published on PyPI for straightforward distribution.
- More scholarly vendors planned for future releases.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Scholarly (arXiv)
    Command (node, npx, python, etc.) uv
    Arguments
    • Argument 1 --directory
    • Argument 2 /Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly
    • Argument 3 run
    • Argument 4 mcp-scholarly

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To install mcp-scholarly for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-scholarly --client claude

search-arxiv

Search arxiv for articles related to the given keyword. Takes 'keyword' as a required string argument.

The server implements one tool:
- search-arxiv: Search arxiv for articles related to the given keyword.
- Takes "keyword" as required string arguments

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "scholarly (arxiv)": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "/Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly",
                "run",
                "mcp-scholarly"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

Linux

{
    "cwd": null,
    "env": [],
    "args": [
        "run",
        "--rm",
        "-i",
        "mcp/scholarly"
    ],
    "shell": false,
    "command": "docker"
}

Macos

{
    "cwd": null,
    "env": [],
    "args": [
        "--directory",
        "/Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly",
        "run",
        "mcp-scholarly"
    ],
    "shell": false,
    "command": "uv"
}

Windows

{
    "cwd": null,
    "env": [],
    "args": [
        "mcp-scholarly"
    ],
    "shell": false,
    "command": "uvx"
}

A MCP server to search for accurate academic articles. More scholarly vendors will be added soon.

- search-arxiv: Search arxiv for articles related to the given keyword.

- Takes "keyword" as required string arguments

On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json

To install mcp-scholarly for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install mcp-scholarly --client claude

To prepare the package for distribution:

This will create source and wheel distributions in thedist/directory.

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

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.

You can launch the MCP Inspector vianpmwith 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.

zorpneeds a search-capable MCP tool beforevalidatewill run. This server satisfies that check, because zorp matches on a search verb in the tool name and these tools are calledsearch-arxivandsearch-google-scholar.

zorp-agent --yes \ --mcp "stdio:scholarly:uv:run:mcp-scholarly" \ validate "<your research question>"

Or configure it once, so every run picks it up:

# .zorp/mcp.toml [[server]] name = "scholarly" transport = "stdio" command = "uv" args = ["run", "mcp-scholarly"] trust = "sandbox" timeout_secs = 60

Notes measured against zorp's transport, not assumed:

- search-arxivanswers in about 1 second. zorp's default stdio read budget is 30 seconds, so the default is comfortable.timeout_secs = 60above is headroom forsearch-google-scholar, which goes throughscholarlyand a free proxy pool and is far less predictable.
- Logging goes to stderr. Nothing but JSON-RPC reaches stdout, which is what zorp's newline-delimited framing requires.
- An empty keyword comes back as an MCP tool error rather than an empty result set. zorp cares about that distinction: a failed search that looks like "no prior work" would put a wrong novelty score into an evidence record.
- arxiv returns best-effort matches for any query, including nonsense, so a non-empty result set is not by itself evidence that prior work exists. The tool description says so, since that is the text the model reads.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Research papers from arXiv, Google Scholar, and Wikipedia with citation metrics

A flexible service for searching and analyzing academic papers on arXiv.

Search and retrieve articles from bioRxiv, the preprint server for biology.

An automated research agent using Google Gemini models and Google Search to perform deep, multi-step web research.

Search and access academic papers on Google Scholar.

Conducts deep research using local Ollama LLMs, leveraging Tavily and Perplexity for comprehensive search capabilities.

MCP server for the Open Archives genealogical search engine.

Intelligent search, reasoning, and research capabilities powered by Perplexity's specialized AI models.

An MCP server to interact with Perplexity AI's language models for search and conversational AI.

Source-first MCP knowledge control tower for watchlists, briefings, grounded search, and evidence-backed Ask.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.