Scholarly

Scholarly

An MCP server to search for scholarly and academic articles.

162
Stars
25
Forks
0
Releases

Overview

mcp-scholarly is an MCP server designed to enable clients to locate scholarly articles by querying reputable scholarly vendors. It currently implements a single tool, search-arxiv, which searches the arXiv repository for articles related to a given keyword. The server runs over the Model Context Protocol's standard input/output model to facilitate integration with clients such as Claude Desktop and other MCP-enabled frontends. The project emphasizes extensibility, with plans to add more scholarly vendors in the future. Quickstart guidance covers installation on Claude Desktop (including development and published server configurations), and Docker-based deployment. Development and publishing are managed with UV tooling: syncing dependencies (uv sync), building distributions (uv build) that place source and wheel files in dist/, and publishing to PyPI (uv publish) with credentials provided via environment variables or command flags. For debugging, the MCP Inspector is recommended and can display a debugging URL when the server starts. The repository also showcases badges and visuals to illustrate usage and status.

Details

Owner
adityak74
Language
Python
License
MIT License
Updated
2025-12-07

Features

search-arxiv tool

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

Runs over stdio

The MCP server operates over standard input/output, enabling integration with MCP clients and frontends.

Claude Desktop installation via Smithery

Provides Smithery-based installation for Claude Desktop (e.g., npx -y @smithery/cli install mcp-scholarly --client claude).

Docker deployment support

Published Docker server configuration and example docker run command to deploy mcp-scholarly.

Development and publishing workflow (uv)

Use uv sync, uv build (producing dist/ with source and wheel), and uv publish to PyPI (with credentials via environment variables or flags).

Debugging with MCP Inspector

Debugging guidance via the MCP Inspector, including launching a debugging URL when the server starts.

Audience

ResearchersSearch for scholarly articles and locate relevant papers through MCP-enabled clients using keywords.
StudentsFind academic sources for coursework and literature reviews via MCP-based workflows.
LibrariansCurate and index scholarly articles from arXiv and future vendors as MCP servers.

Tags

MCParxivacademicscholarlysearchserverClaudeDocker