ArXiv-MCP

模型上下文协议 (MCP)服务器实现，使 AI 代理能够从流行的开放存取电子预印本存储库arXiv搜索、检索和分析学术论文。

概述

该项目提供了一个 MCP 服务器，允许 AI 代理与 arXiv 存储库交互，根据关键词搜索论文，检索特定论文的详细信息，甚至提取和分析论文内容。它既是一个实用的研究辅助工具，也是构建 MCP 服务器的参考实现。

该实施遵循构建 MCP 服务器的最佳实践，允许与任何兼容 MCP 的客户端无缝集成。

特征

该服务器为学术研究提供了几种强大的工具：

1. search_papers ：使用关键词在 arXiv 上搜索论文并获取综合摘要
2. get_paper_details ：通过 arXiv ID 检索特定论文的详细信息
3. extract_paper_content ：从论文的 PDF 中下载并提取全文内容
4. analyze_paper ：分析论文内容并生成综合摘要

先决条件

• Python 3.11+
• 如果将 MCP 服务器作为容器运行，则使用 Docker（推荐）

安装

使用 uv

1. 如果没有 uv，请安装：
   pip install uv
2. 克隆此存储库：
   git clone https://github.com/kelvingao/arxiv-mcp.git cd arxiv-mcp
3. 安装依赖项：
   uv pip install -e .
4. 根据.env.example创建.env文件：
   cp .env.example .env
5. 在.env文件中配置环境变量（参见配置部分）

使用 Docker（推荐）

1. 构建 Docker 镜像：
   docker build -t mcp/arxiv --build-arg PORT=8050 .
2. 根据.env.example创建.env文件并配置环境变量

配置

您可以在.env文件中配置以下环境变量：

运行服务器

使用 uv

上交所运输

MCP 服务器将作为 API 端点运行，您可以使用下面显示的配置连接到该端点。

标准传输

使用 stdio，MCP 客户端本身可以启动 MCP 服务器，因此此时无需运行任何操作。

使用 Docker

上交所运输

MCP 服务器将作为容器内的 API 端点运行，您可以使用下面显示的配置连接到该容器。

标准传输

使用 stdio，MCP 客户端本身可以启动 MCP 服务器容器，因此此时无需运行任何内容。

与 MCP 客户端集成

SSE配置

一旦服务器使用 SSE 传输运行，您就可以使用以下配置连接到它：

Windsurf 用户请注意：在配置中使用serverUrl而不是url ：

{ "mcpServers": { "arxiv": { "transport": "sse", "serverUrl": "http://localhost:8050/sse" } } }

n8n 用户请注意：使用 host.docker.internal 而不是 localhost，因为 n8n 必须到达其自身容器之外的主机：

因此 MCP 节点中的完整 URL 为： http://host.docker.internal:8050/sse

如果您使用的不是默认值 8050，请确保更新端口。

Python 与 Stdio 配置

将此服务器添加到 Claude Desktop、Windsurf 或任何其他 MCP 客户端的 MCP 配置中：

Docker 与 Stdio 配置

使用示例

以下是一些如何将 arXiv MCP 服务器与 AI 代理一起使用的示例：

寻找论文

获取论文详细信息

提取纸质内容

分析论文

构建您自己的 MCP 服务器

此实现为构建更复杂的 MCP 服务器奠定了基础。要构建您自己的服务器，请执行以下操作：

1. 通过使用@mcp.tool()装饰器创建方法添加您自己的工具
2. 创建自己的生命周期函数来添加自己的依赖项（客户端、数据库连接等）
3. 修改现有工具或添加新工具以增强功能
4. 使用@mcp.resource()和@mcp.prompt()添加提示和资源

执照

MIT 许可证

致谢

• arXiv提供研究论文的开放获取
• 创建 MCP 标准的模型上下文协议团队