ArXiv MCP 服务器

🔍 使 AI 助手能够通过简单的 MCP 接口搜索和访问 arXiv 论文。

ArXiv MCP 服务器通过消息控制协议 (MCP) 在 AI 助手和 arXiv 的研究存储库之间提供桥梁。它允许 AI 模型以编程方式搜索论文并访问其内容。

<div align="center">

🤝 贡献 • 📝 报告 Bug

</div>

✨ 核心功能

• 🔎 论文搜索: 使用日期范围和类别过滤器查询 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"
            ]
        }
    }
}

用于开发：

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/arxiv-mcp-server",
                "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. 论文下载

通过 arXiv ID 下载论文：

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"
})

⚙️ 配置

通过环境变量配置：

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

🧪 测试

运行测试套件：

python -m pytest

📄 许可证

在 MIT 许可证下发布。 有关详细信息，请参见 LICENSE 文件。

---

<div align="center">

由 Pear Labs 团队用 ❤️ 制作

<a href="https://glama.ai/mcp/servers/04dtxi5i5n"><img width="380" height="200" src="https://glama.ai/mcp/servers/04dtxi5i5n/badge" alt="ArXiv Server MCP server" /></a> </div>