ArXiv MCP Server 使用说明

项目简介

ArXiv MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它充当 AI 助手和 arXiv 学术论文库之间的桥梁。通过这个服务器，AI 模型可以方便地搜索 arXiv 上的论文，并获取论文内容，从而进行更深入的学术研究和分析。

主要功能点

论文搜索: 允许用户通过关键词、日期范围和论文分类等条件在 arXiv 上查找相关的学术论文。
论文访问: 支持下载 arXiv 论文，并存储在本地以便快速访问和阅读。
论文管理: 可以列出所有已下载的论文，方便用户管理本地论文库。
内容读取: 能够读取已下载论文的 Markdown 格式内容，方便 AI 模型理解和处理。
研究 Prompt: 提供预定义的 Prompt 模板，例如“深度论文分析”，帮助用户更高效地分析学术论文。

安装步骤

手动安装 (推荐): 打开终端，复制并执行以下命令以安装 ArXiv MCP Server：
```
uv tool install arxiv-mcp-server
```
这将使用 'uv' 工具安装 'arxiv-mcp-server'。

服务器配置

要让 MCP 客户端（例如 Claude）连接到 ArXiv MCP Server，您需要在客户端的 MCP 服务器配置文件中添加以下配置信息。

基础配置 (手动安装):

{
    "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'。
'"args"': 启动服务器的参数列表。
- '"tool"': 'uv tool run' 命令的一部分，表示运行一个工具。
- '"run"': 'uv tool run' 命令的一部分，表示运行。
- '"arxiv-mcp-server"': 指定要运行的工具名称为 'arxiv-mcp-server'，即您安装的 ArXiv MCP Server。
- '"--storage-path", "/path/to/paper/storage"': 重要参数，指定论文存储的本地路径。请将 '"/path/to/paper/storage"' 替换为您希望存储论文的实际本地文件夹路径。例如，您可以设置为 '"/Users/your_username/arxiv_papers"'。

请务必将 '"/path/to/paper/storage"' 替换为您电脑上实际存在的文件夹路径，以便服务器能够正确存储下载的论文。

基本使用方法

配置完成后，您的 MCP 客户端应该能够检测到 ArXiv MCP Server。您可以使用客户端提供的界面或命令来调用服务器提供的工具和 Prompt。

可用工具 (Tools):

'search_papers': 搜索 arXiv 论文。您需要提供 'query' (搜索关键词) 作为输入，还可以选择性地添加 'max_results' (最大结果数)、'date_from' (起始日期)、'date_to' (结束日期)、'categories' (论文分类) 等参数进行更精确的搜索。
'download_paper': 下载指定 arXiv ID 的论文。您需要提供 'paper_id' (arXiv 论文ID) 作为输入。
'list_papers': 列出所有已下载的论文。无需任何输入参数。
'read_paper': 读取指定 arXiv ID 论文的内容。您需要提供 'paper_id' (arXiv 论文ID) 作为输入。

可用 Prompt (Prompts):

'deep-paper-analysis': 深度论文分析 Prompt。您需要提供 'paper_id' (arXiv 论文ID) 作为输入，服务器将返回一个包含详细论文分析指令的 Prompt，您可以将其发送给 LLM 进行论文分析。

使用示例 (假设您使用支持 MCP 协议的 AI 客户端):

搜索论文: 在客户端中调用 'search_papers' 工具，并输入关键词，例如 '"transformer architecture"'。服务器将返回与关键词相关的 arXiv 论文列表。
下载论文: 从搜索结果中选择一篇论文，获取其 arXiv ID，然后调用 'download_paper' 工具，并输入论文 ID。服务器将下载该论文并存储在您配置的本地路径。
读取论文: 调用 'read_paper' 工具，并输入已下载论文的 arXiv ID。服务器将返回论文的 Markdown 格式内容。
论文分析: 调用 'deep-paper-analysis' Prompt，并输入论文 ID。服务器将返回深度分析 Prompt，您可以将此 Prompt 和论文内容一起发送给 LLM 进行深入分析。

通过 ArXiv MCP Server，您可以方便地将 arXiv 的海量学术资源整合到您的 AI 助手工作流程中，提升 AI 在学术研究领域的应用能力。

关键词