AI导哈

arXiv论文搜索服务

一个连接Claude Desktop和arXiv API的模型上下文协议服务器，用于搜索、筛选和检索学术论文。

  • by aarangop
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aarangop/arxiv-mcp

使用说明

arXiv助手MCP服务器

一个模型上下文协议（MCP）服务器，使Claude Desktop能够搜索 关于arXiv的科学论文。该服务器充当克劳德和 arXiv API，允许Claude搜索、过滤和检索学术论文 直接。

特性

  • 搜索论文 按标题、作者、摘要、类别等
  • 筛选结果 使用arXiv强大的查询语法
  • 整理纸张 按相关性、提交日期或更新日期
  • 查看纸张详细信息 包括摘要、作者和出版物链接
  • 支持分页 浏览大型结果集

先决条件

  • Python 3.10+
  • 紫外线 用于依赖关系管理
  • Claude桌面应用程序

安装

此项目使用 紫外线 依赖性 管理。

# Clone this repository (if you haven't already)
git clone https://github.com/aarangop/arxiv-mcp.git
cd arxiv_mcp

安装星光紫外线

# Install uv if you haven't already
# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh


powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装依赖项

# Install dependencies using uv
uv add
uv add --dev

如果你没有安装uv，你可以按照以下步骤安装它 官方文件.

用法

手动运行服务器：

python main.py

使用Claude Desktop进行设置

要将此arXiv助手添加到Claude Desktop，您需要修改Claude 桌面配置文件。

配置文件通常位于：

~/Library/Application Support/Claude/claude_desktop_config.json

将以下部分添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "arxiv_assistant": {
      "command": "/path/to/your/uv",
      "args": [
        "--directory",
        "/path/to/your/arxiv_mcp/folder",
        "run",
        "main.py"
      ]
    }
  }
}

将路径替换为系统上的实际路径：

  • /path/to/your/uv -uv可执行文件的路径（例如。， /Users/username/.local/bin/uv)
  • /path/to/your/arxiv_mcp/folder -此存储库文件夹的完整路径

配置示例

以下是一个配置示例：

{
  "mcpServers": {
    "arxiv_assistant": {
      "command": "/Users/username/.local/bin/uv",
      "args": ["--directory", "/path/to/arxiv_mcp/", "run", "main.py"]
    }
  }
}

保存对配置文件的更改后，重新启动Claude Desktop 这些变化将生效。

在Claude中使用arXiv Helper

一旦使用Claude Desktop设置了MCP服务器，您就可以使用arXiv 通过要求Claude执行以下操作来实现功能：

  • “搜索最近关于机器学习的论文”
  • “查找'Yoshua Bengio'关于深度学习的论文”
  • “查找cs.AI类别中关于变压器的论文”
  • “给我看看今年发表的量子计算论文”

Claude将使用arXiv API获取相关论文并显示结果。

测试

该项目包括两组测试：

  1. API客户端的集成测试(test_search_papers.py)
  2. 解析函数的单元测试(test_parsing_functions.py)

运行测试

用紫外线运行所有测试：

uv run pytest

运行特定的测试文件：

# Run the API integration tests
uv run pytest test_search_papers.py

# Run the parsing function unit tests
uv run pytest test_parsing_functions.py

运行具有详细输出的测试：

uv run pytest -v

故障排除

如果您遇到问题：

  1. 确保您的Claude配置正确
  2. 验证arXiv API是否可以从您的网络访问
  3. 使用附带的实用程序脚本：
    • ./show_logs.sh -实时查看Claude的MCP相关日志
    • ./inspect.sh -运行MCP检查器调试MCP服务器（需要 npx）

许可证

MIT许可证 或在此处指定您的许可证信息。

贡献

欢迎投稿！请随时提交拉取请求。

致谢

感谢arXiv使用其开放访问互操作性！

相关 MCP