Skip to main content
Glama
win4r

arxiv-search MCP Server

by win4r
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

arxiv-search MCP Server

🚀对应视频演示

🚀我的微信：stoeng

English | 中文

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

Related MCP server: arXiv MCP Server

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)

arXiv搜索 MCP 服务器

一个用于搜索arXiv学术论文的模型上下文协议(MCP)服务器。

该服务器提供了搜索arXiv学术论文并获取详细信息的工具。它通过以下方式展示了MCP的核心概念：

  • 使用URI和元数据表示学术论文的资源

  • 提供带有可自定义参数的论文搜索工具

  • 支持搜索结果的排序和分页

功能特点

资源

  • 通过arxiv://paper/{id}URI列出和访问论文

  • 每篇论文包含标题、作者、摘要、发布日期和PDF链接

  • 使用JSON mime类型进行结构化内容访问

工具

  • search_papers - 在arXiv上搜索学术论文

    • 需要query作为必填参数

    • 可选参数包括最大结果数、排序方式和分页

    • 返回带有论文详细信息的格式化结果

开发

安装依赖:

npm install

构建服务器:

npm run build

用于自动重新构建的开发模式:

npm run watch

安装

要与Claude桌面应用一起使用，添加服务器配置:

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

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

要与VSCode和Roo Cline一起使用，添加到: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

调试

由于MCP服务器通过stdio通信，调试可能具有挑战性。我们推荐使用MCP Inspector，可通过以下包脚本使用:

npm run inspector

Inspector将提供一个URL，用于在浏览器中访问调试工具。

使用示例

<use_mcp_tool>
<server_name>arxiv-search</server_name>
<tool_name>search_papers</tool_name>
<arguments>
{
  "query": "机器学习",
  "max_results": 5,
  "sort_by": "relevance"
}
</arguments>
</use_mcp_tool>

可用参数:

  • query (必填): 搜索查询（例如：'机器学习'，'量子物理'）

  • max_results (可选): 返回结果的最大数量（默认：10，最大：100）

  • sort_by (可选): 排序方式（'relevance'相关性, 'lastUpdatedDate'最后更新日期, 'submittedDate'提交日期）

  • start (可选): 结果的起始索引（用于分页）

Available Tools

1 tool
search_papersB

搜索arXiv学术论文

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes搜索查询（例如：'machine learning', 'quantum physics'等）
startNo结果的起始索引（用于分页）
sort_byNo排序方式（relevance, lastUpdatedDate, submittedDate）
max_resultsNo返回结果的最大数量（默认为10，最大为100）

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It only states the action and target, but provides no information about pagination, sorting behavior, result limits, or any side effects. This is a significant gap for a search tool with 4 parameters.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence that immediately states the tool's purpose. There is zero wordiness or irrelevant information, making it exemplary in conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 4 parameters, no output schema, and no annotations, the description is too sparse. It does not explain what the search returns, how pagination works, or any nuances about sorting. The agent would lack critical context for effectively using this tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, so all parameters are already fully documented. The description adds no additional meaning beyond the schema, which puts it at the baseline score of 3. It does not compensate for any gaps because there are none.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific verb ('search') and resource ('arXiv academic papers'), which makes the tool's purpose unambiguous. Since there are no sibling tools to differentiate from, the lack of explicit distinction is not a significant fault, but the description is minimal and could be more specific about what it returns.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The usage is implied: this tool searches arXiv for papers. However, there is no explicit guidance on when to use it, when not to use it, or any mention of alternatives. The context is clear but not elaborated, so it earns a mid-range score.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev0.1.0
    • First observedsearch_papers
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap. The tool's purpose is clear from its name and description.

Naming Consistency5/5

The single tool uses a clear verb_noun pattern (search_papers). With no other tools, consistency is perfect.

Tool Count2/5

Providing only one tool is too few for an arxiv search server, which could reasonably support fetching paper details, listing recent papers, or category-based filtering. The current scope feels thin.

Completeness2/5

The server only offers a general search. There are no tools for retrieving a specific paper by ID, accessing metadata, or managing results, leaving significant gaps in the expected functionality.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ArXiv Paper MCP

    BACH-AI-Tools
    A
    license
    B
    quality
    D
    maintenance
    Enables searching, retrieving, and parsing academic papers from arXiv, including keyword search, PDF downloads, content extraction from HTML/PDF formats, and accessing the latest AI research papers.
    4
    7 npm
    MIT

  • arXiv MCP Server

    Mnehmos
    A
    license
    B
    quality
    D
    maintenance
    Enables searching and retrieving academic papers from arXiv by various criteria including title, author, and category, with support for extracting full text content from PDFs.
    4
    MIT

  • MCP Research Server (arXiv)

    SinghAngad05
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables searching and retrieving academic papers from arXiv by topic, allowing users to discover research papers and extract their metadata including titles, authors, abstracts, and PDF links through natural language queries.
    -

  • arXiv MCP Server

    Ray0907
    A
    license
    A
    quality
    B
    maintenance
    Enables searching and retrieving academic papers from arXiv with support for advanced filtering by author, category, and date, plus full paper content extraction.
    6
    14
    MIT