📚 arXiv MCP Server

通过模型上下文协议访问全球最大的学术论文库

一个精简的 模型上下文协议 服务，可将 AI 助手连接到 arXiv 丰富的学术论文库。可直接在 AI 工作流中搜索、分析和下载研究论文。

🚀 快速开始

先决条件

• Python 3.12+
• uv 包管理器

安装

选项 1：Docker（推荐）

# Pull and run the Docker image
docker run --rm -it ghcr.io/tejas242/arxiv-mcp:latest

# Or using docker-compose
git clone https://github.com/tejas242/arxiv-mcp.git
cd arxiv-mcp
docker compose up

选项 2：本地开发

# Clone and setup
git clone https://github.com/tejas242/arxiv-mcp.git
cd arxiv-mcp
uv sync

# Test the server
uv run main.py

🛠️ 可用功能

功能详情

✅ 完全可用的功能

search_papers - 主要搜索功能

• 支持完整的 arXiv 查询语法
• 支持关键词、作者、类别和标题
• 可配置排序和分页
• 返回包含摘要和链接的格式化结果

get_paper_details - 论文详细信息

• 提取完整元数据
• 作者信息及所属机构
• 类别分类和链接
• 发表日期和更新记录

build_advanced_query - 查询构建辅助工具

• 组合多个搜索条件
• 支持标题、作者、类别和摘要搜索
• 返回格式正确的查询字符串

get_arxiv_categories - 类别参考

• arXiv 学科类别完整列表
• 每个类别的描述
• 有助于构建有针对性的搜索

⚠️ 功能有限（有可用的替代方案）

search_by_author - 请改用 search_papers('au:"Author Name"') search_by_category - 请改用 search_papers('cat:category_code')

🔧 需要修复的功能

download_paper_pdf - 需要改进 HTTP 重定向处理

• 目前因 HTTPS/HTTP 重定向问题而失败
• 可通过搜索结果中提供的链接直接访问 PDF

⚙️ 配置

Claude Desktop 设置

{
  "mcpServers": {
    "arxiv-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/arxiv-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

{
  "mcpServers": {
    "arxiv-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/tejas242/arxiv-mcp:latest"
      ]
    }
  }
}

VS Code MCP 扩展

{
  "mcp": {
    "servers": {
      "arxiv-mcp": {
        "command": "uv",
        "args": ["--directory", "/path/to/arxiv-mcp", "run", "main.py"]
      }
    }
  }
}

💡 使用示例

核心搜索操作

# Search for papers about transformers
search_papers("transformer architecture")

# Advanced query with specific fields
search_papers('ti:"attention mechanism" AND cat:cs.LG')

# Author-specific search (recommended approach)
search_papers('au:"Geoffrey Hinton"')

# Category browsing (recommended approach)
search_papers('cat:cs.AI')

研究工作流

# 1. Find the famous "Attention" paper
search_papers('ti:"Attention Is All You Need"')
get_paper_details("1706.03762")

# 2. Explore related work
search_papers("transformer neural networks")

# 3. Build complex queries
query = build_advanced_query(
    title_keywords="few-shot learning",
    author_name="Tom Brown",
    category="cs.LG"
)
search_papers(query)

📊 arXiv 分类参考

使用 get_arxiv_categories() 获取完整的可用分类列表。

🧪 测试结果

根据对所有功能进行的全面测试：

✅ 稳定可靠的功能

• 按关键词、作者和分类搜索论文：成功率 100%
• 获取论文详情：完整元数据提取功能正常
• 构造查询：支持所有语法组合
• 分类列表：可访问所有 arXiv 分类

⚠️ 建议使用替代方式

• 作者搜索：请使用 search_papers('au:"Author Name"')，而非 search_by_author()
• 分类浏览：请使用 search_papers('cat:category')，而非 search_by_category()

🔧 已知问题

• PDF 下载：需要改进重定向处理（可通过直接链接访问 PDF）

🔧 开发

项目结构

arxiv-mcp/
├── src/arxiv_mcp/          # Main package
│   ├── server.py           # MCP server implementation
│   ├── arxiv_client.py     # arXiv API wrapper
│   ├── models.py           # Pydantic data models
│   └── utils.py            # Helper functions
├── tests/                  # Test suite
├── main.py                 # Entry point
└── pyproject.toml         # Project config

运行测试

uv run pytest tests/ -v

调试模式

# Enable detailed logging
PYTHONPATH=src uv run python -c "
import logging
logging.basicConfig(level=logging.DEBUG)
from arxiv_mcp.server import main
main()
"

⚠️ 故障排除

• arXiv
• Model Context Protocol