ArXiv MCP Server

ArXiv MCP Server

site icon
2025.04.11 912
Python学术研究论文搜索AI辅助工具搜索工具开发效率
ArXiv MCP Server 是一个为AI助手设计的桥梁,通过Message Control Protocol (MCP)接口,使AI模型能够搜索和访问arXiv的研究论文。该服务提供了论文搜索、下载、列表查看和内容访问等功能,支持本地存储以加快访问速度,并包含一套研究提示工具,帮助分析学术论文。
View on GitHub

Overview

✨ 核心功能

  • 🔎 论文搜索: 支持按日期范围和类别筛选查询arXiv论文
  • 📄 论文访问: 下载和阅读论文内容
  • 📋 论文列表: 查看所有已下载的论文
  • 🗃️ 本地存储: 论文保存在本地以加快访问速度
  • 📝 研究提示: 一套用于分析学术论文的提示工具

🚀 快速开始

通过Smithery安装

使用Smithery自动为Claude Desktop安装ArXiv Server:

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

手动安装

使用uv安装:

uv tool install arxiv-mcp-server

开发环境设置:

git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server
uv venv
source .venv/bin/activate
uv pip install -e ".[test]"

🔌 MCP集成

在MCP客户端配置文件中添加以下配置:

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

💡 可用工具

1. 论文搜索

result = await call_tool("search_papers", {
    "query": "transformer architecture",
    "max_results": 10,
    "date_from": "2023-01-01",
    "categories": ["cs.AI", "cs.LG"]
})

2. 论文下载

result = await call_tool("download_paper", {
    "paper_id": "2401.12345"
})

3. 论文列表

result = await call_tool("list_papers", {})

4. 阅读论文

result = await call_tool("read_paper", {
    "paper_id": "2401.12345"
})

📝 研究提示

论文分析提示

result = await call_prompt("deep-paper-analysis", {
    "paper_id": "2401.12345"
})

⚙️ 配置

通过环境变量配置:

变量 用途 默认值
ARXIV_STORAGE_PATH 论文存储位置 ~/.arxiv-mcp-server/papers

🧪 测试

运行测试套件:

python -m pytest

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。