ArXiv MCP Server 使用说明

项目简介

ArXiv MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,它充当 AI 助手和 arXiv 学术论文库之间的桥梁。通过标准化的 MCP 接口,AI 模型可以方便地搜索 arXiv 论文、下载论文内容,并进行内容访问,从而增强 AI 在科研信息检索和利用方面的能力。

主要功能点

  • 论文搜索: 允许用户通过关键词、日期范围和论文分类等条件在 arXiv 上检索论文。
  • 论文下载: 支持根据 arXiv 论文 ID 下载论文的 PDF 文件,并将其存储在本地。
  • 论文列表: 展示所有已下载并存储在本地的论文列表。
  • 论文阅读: 提供访问已下载论文内容的功能,方便 AI 模型理解论文内容。

安装步骤

  1. 安装:使用 'uv pip' 命令即可安装 ArXiv MCP Server:
    uv pip install git+https://github.com/MCP-Mirror/blazickjp_arxiv-mcp-server.git

服务器配置

为了让 MCP 客户端能够连接到 ArXiv MCP Server,您需要在客户端的配置文件中添加以下服务器配置信息。请注意,以下配置信息为 JSON 格式,您只需复制粘贴到您的 MCP 客户端配置文件中即可。

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

配置参数说明

  • server name: 'arxiv-mcp-server' - 服务器名称,用于在 MCP 客户端中标识该服务器。
  • command: 'uv' - 运行服务器的命令,这里假设您已安装 'uv'。
  • args: 启动参数列表,包括:
    • 'run':'uv run' 子命令用于运行 Python 模块或脚本。
    • 'arxiv-mcp-server':指定要运行的 Python 入口点,即 'arxiv_mcp_server' 包。
    • '--storage-path':可选参数,用于指定论文存储路径。请将 '/path/to/paper/storage' 替换为您希望存储论文的实际本地路径。如果省略此参数,服务器将使用默认存储路径 '~/.arxiv-mcp-server/papers'。

基本使用方法

ArXiv MCP Server 通过工具 (Tools) 提供功能。您可以使用 MCP 客户端调用以下工具来与 arXiv 进行交互:

  1. 搜索论文 (search_papers): 根据关键词搜索 arXiv 论文。

    {
        "tool_call": {
            "tool_name": "search_papers",
            "tool_arguments": {
                "query": "transformer architecture",
                "max_results": 10,
                "date_from": "2023-01-01",
                "categories": ["cs.AI", "cs.LG"]
            }
        }
    }

    参数说明:

    • 'query': 搜索关键词。
    • 'max_results': 最多返回的论文数量(可选)。
    • 'date_from': 起始日期,格式为 'YYYY-MM-DD'(可选)。
    • 'date_to': 结束日期,格式为 'YYYY-MM-DD'(可选)。
    • 'categories': 论文分类列表,例如 '["cs.AI", "cs.LG"]'(可选)。
  2. 下载论文 (download_paper): 下载指定 arXiv ID 的论文。

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

    参数说明:

    • 'paper_id': 要下载的 arXiv 论文 ID。
  3. 列出已下载论文 (list_papers): 查看所有已下载的论文列表。

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

    该工具无需参数。

  4. 阅读论文 (read_paper): 读取已下载论文的内容。

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

    参数说明:

    • 'paper_id': 要阅读的 arXiv 论文 ID。

请注意,您需要使用 MCP 客户端发送符合 MCP 协议的 JSON-RPC 请求来调用这些工具。具体的调用方式请参考您的 MCP 客户端的使用文档。

信息

分类

网页与API