ArXiv MCP Server 使用说明

项目简介

ArXiv MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它充当 AI 助手和 arXiv 学术论文库之间的桥梁。通过 MCP 协议，该服务器允许 AI 模型以程序化的方式搜索 arXiv 论文并访问论文内容，从而扩展 AI 助手在学术研究领域的应用能力。

主要功能点

论文搜索: 允许用户通过关键词、日期范围和论文分类检索 arXiv 上的学术论文。
论文访问: 支持下载 arXiv 论文的 PDF 文件，并将其转换为 Markdown 格式存储在本地。
论文管理: 提供已下载论文的列表查看功能，方便用户管理本地论文库。
内容读取: 支持读取已下载论文的 Markdown 内容，方便 AI 模型理解和处理论文信息。
研究Prompt: 内置了一系列用于学术研究的 Prompt 模板，帮助用户更高效地进行文献探索和分析。

安装步骤

方法一：使用 Smithery 自动安装 (推荐 Claude Desktop 用户使用)

如果你的 MCP 客户端是 Claude Desktop，可以使用 Smithery 命令行工具一键安装 ArXiv MCP Server：

npx -y @smithery/cli install arxiv-mcp-server --client claude

方法二：手动安装

安装 'uv' 工具

如果你的系统尚未安装 'uv'，请先安装 'uv' 工具。你可以参考 uv installation 进行安装。

安装 ArXiv MCP Server

使用 'uv tool install' 命令安装 'arxiv-mcp-server'：

uv tool install arxiv-mcp-server

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 ArXiv MCP Server，你需要在客户端的 MCP 服务器配置文件中添加以下配置信息。通常，这个配置文件是一个 JSON 文件。

基础配置 (推荐)

以下配置适用于大多数用户。请将 '/path/to/paper/storage' 替换为你希望存放下载论文的本地文件夹路径。

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

配置参数说明:

'"arxiv-mcp-server"': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv tool run' 来运行已安装的 'arxiv-mcp-server' 工具。
'"args"': 传递给 'uv tool run arxiv-mcp-server' 命令的参数列表。
- '"tool"': 'uv tool run' 的子命令，表示运行一个工具。
- '"run"': 'uv tool run' 的子命令，表示运行。
- '"arxiv-mcp-server"': 要运行的工具名称，即 ArXiv MCP Server。
- '"--storage-path", "/path/to/paper/storage"': 'arxiv-mcp-server' 的参数，指定论文存储路径。请务必替换为你的实际路径。

开发配置 (如果你从 GitHub 克隆了仓库进行开发)

如果你是从 GitHub 克隆了 'arxiv-mcp-server' 仓库进行开发，可以使用以下配置。请将 '"path/to/cloned/arxiv-mcp-server"' 替换为你克隆仓库的本地路径，'/path/to/paper/storage' 同样需要替换为你希望存放论文的路径。

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/arxiv-mcp-server",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

开发配置参数说明:

大部分参数与基础配置相同。
'"--directory", "path/to/cloned/arxiv-mcp-server"': 额外的 'uv tool run' 参数，用于指定从本地仓库目录运行 'arxiv-mcp-server'，方便开发调试。请替换为你的实际仓库路径。

基本使用方法

配置完成后，在你的 MCP 客户端中，你可以通过以下工具与 ArXiv MCP Server 交互：

搜索论文 (search_papers)

调用 'search_papers' 工具，并提供以下参数：

'query': 搜索关键词 (必填)。
'max_results': 最大返回结果数量 (可选，默认 10)。
'date_from': 起始日期，格式 YYYY-MM-DD (可选)。
'date_to': 结束日期，格式 YYYY-MM-DD (可选)。
'categories': 论文分类列表，例如 '["cs.AI", "cs.LG"]' (可选)。

示例: 搜索关于 "transformer architecture" 的论文，最多返回 5 篇，类别为 "cs.AI" 或 "cs.LG"。

{
    "tool_call": {
        "tool_name": "search_papers",
        "arguments": {
            "query": "transformer architecture",
            "max_results": 5,
            "categories": ["cs.AI", "cs.LG"]
        }
    }
}

下载论文 (download_paper)

调用 'download_paper' 工具，并提供以下参数：

'paper_id': arXiv 论文 ID (必填)，例如 "2401.12345"。
'check_status': 是否仅检查下载状态，不执行下载 (可选，默认为 false)。

示例: 下载 arXiv ID 为 "2401.12345" 的论文。

{
    "tool_call": {
        "tool_name": "download_paper",
        "arguments": {
            "paper_id": "2401.12345"
        }
    }
}

列出已下载论文 (list_papers)

调用 'list_papers' 工具，无需参数。

{
    "tool_call": {
        "tool_name": "list_papers",
        "arguments": {}
    }
}

读取论文内容 (read_paper)

调用 'read_paper' 工具，并提供以下参数：

'paper_id': 已下载的 arXiv 论文 ID (必填)。

示例: 读取 arXiv ID 为 "2401.12345" 的论文内容。

{
    "tool_call": {
        "tool_name": "read_paper",
        "arguments": {
            "paper_id": "2401.12345"
        }
    }
}

使用 Prompt 模板

你可以使用服务器提供的 Prompt 模板来辅助研究，例如 "research-discovery", "paper-analysis", "literature-synthesis"。具体 Prompt 的使用方法请参考 MCP 客户端的相关文档。

环境变量配置

你还可以通过环境变量 'ARXIV_STORAGE_PATH' 来自定义论文的存储路径。如果未设置该环境变量，默认存储路径为用户 home 目录下的 '.arxiv-mcp-server/papers' 文件夹。

export ARXIV_STORAGE_PATH=/your/custom/path/for/papers

注意: 请确保 MCP 客户端和 ArXiv MCP Server 能够正常通信，并根据你的实际需求配置服务器和使用工具。

关键词