ArXiv MCP Server 使用说明
项目简介
ArXiv MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,它充当 AI 助手和 arXiv 学术论文库之间的桥梁。通过标准化的 MCP 接口,AI 模型可以方便地搜索 arXiv 论文、下载论文内容,并进行内容访问,从而增强 AI 在科研信息检索和利用方面的能力。
主要功能点
- 论文搜索: 允许用户通过关键词、日期范围和论文分类等条件在 arXiv 上检索论文。
- 论文下载: 支持根据 arXiv 论文 ID 下载论文的 PDF 文件,并将其存储在本地。
- 论文列表: 展示所有已下载并存储在本地的论文列表。
- 论文阅读: 提供访问已下载论文内容的功能,方便 AI 模型理解论文内容。
安装步骤
- 安装:使用 '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 进行交互:
-
搜索论文 (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"]'(可选)。
-
下载论文 (download_paper): 下载指定 arXiv ID 的论文。
{ "tool_call": { "tool_name": "download_paper", "tool_arguments": { "paper_id": "2401.12345" } } }参数说明:
- 'paper_id': 要下载的 arXiv 论文 ID。
-
列出已下载论文 (list_papers): 查看所有已下载的论文列表。
{ "tool_call": { "tool_name": "list_papers", "tool_arguments": {} } }该工具无需参数。
-
阅读论文 (read_paper): 读取已下载论文的内容。
{ "tool_call": { "tool_name": "read_paper", "tool_arguments": { "paper_id": "2401.12345" } } }参数说明:
- 'paper_id': 要阅读的 arXiv 论文 ID。
请注意,您需要使用 MCP 客户端发送符合 MCP 协议的 JSON-RPC 请求来调用这些工具。具体的调用方式请参考您的 MCP 客户端的使用文档。
信息
分类
网页与API