arxiv-search MCP Server

by win4r

7 stars
438 downloads
Not rated
GitHub

About

A Model Context Protocol server for searching academic papers on arXiv.

Details

Author
win4r
GitHub stars
7
Downloads
438
Categories
Search

- Resources served via arxiv://paper/{id} URIs.
- Each paper includes title, authors, summary, date, and PDF link.
- Tool search_papers with customizable query, results count, and sorting.
- Supports sorting by relevance, last updated date, or submission date.
- Pagination support via a start parameter.
- Returns structured JSON content.

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 arxiv-search MCP Server
    Command (node, npx, python, etc.)

    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

Install dependencies with npm install, build with npm run build, then add the server configuration to your MCP client. For Claude Desktop, edit claude_desktop_config.json with command node and args pointing to the built index.js. For VSCode and Roo Cline, add to cline_mcp_settings.json. Use the search_papers tool with a required query parameter and optional max_results, sort_by, and start parameters.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "arxiv-search mcp server": {
            "arxiv-search": {
                "command": "node",
                "args": [
                    "/path/to/arxiv-search/build/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "arxiv-search": {
        "command": "node",
        "args": [
            "/path/to/arxiv-search/build/index.js"
        ]
    }
}

arxiv-search MCP Server

🚀对应视频演示

🚀我的微信:stoeng

English | 中文

<a name="english"></a>

A Model Context Protocol server for searching academic papers on arXiv.

This server provides tools to search for academic papers on arXiv and access detailed information about them. It demonstrates core MCP concepts by providing:

- Resources representing academic papers with URIs and metadata
- Tools for searching papers with customizable parameters
- Support for sorting and pagination of search results

Features

Resources

- List and access papers via arxiv://paper/{id} URIs - Each paper has title, authors, summary, publication date, and PDF link - JSON mime type for structured content access

Tools

- search_papers - Search for academic papers on arXiv - Takes query as required parameter - Optional parameters for max results, sorting, and pagination - Returns formatted results with paper details

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

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

{
  "mcpServers": {
    "arxiv-search": {
      "command": "node",
      "args": ["/path/to/arxiv-search/build/index.js"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

To use with VSCode and Roo Cline, add to:
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Usage Examples

<use_mcp_tool>
<server_name>arxiv-search</server_name>
<tool_name>search_papers</tool_name>
<arguments>
{
  "query": "machine learning",
  "max_results": 5,
  "sort_by": "relevance"
}
</arguments>
</use_mcp_tool>

Available parameters:
- query (required): Search query (e.g., 'machine learning', 'quantum physics')
- max_results (optional): Maximum number of results to return (default: 10, max: 100)
- sort_by (optional): Sort method ('relevance', 'lastUpdatedDate', 'submittedDate')
- start (optional): Starting index for results (for pagination)

---

<a name="中文"></a>

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.