Arxiv Semantic Search

arXiv 搜索 MCP

一个轻量级的 Model Context Protocol 服务，可让 AI 助手查询 arXiv API。它提供两种强大的搜索方式：

• 语义搜索：使用向量嵌入理解查询的含义，由 ArxivSearch 提供支持

  注意：目前，语义搜索仅支持计算机科学（cs.*）类别的论文

• 关键词搜索：支持结构化查询，可使用类别、日期范围和特定字段搜索等多种筛选条件

  注意：支持所有 arXiv 类别的论文

要求

• Python 3.12 或更高版本
• uv 包管理器（依赖解析器和运行器）

开始使用

1. 克隆并安装依赖项

# Clone the repository
git clone https://github.com/icyclv/arxiv-semantic-search-mcp.git
cd arxiv-semantic-search-mcp

# Install all project dependencies listed in pyproject.toml
uv sync

2. 在本地运行服务

# Start the MCP server
uv run main.py

编辑器 / 客户端配置

要在 AI 助手工具（例如 Claude Desktop、VS Code MCP 扩展）中使用此 MCP 服务，请添加以下配置：

{
  "mcpServers": {
    "arxiv-semantic-search": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/arxiv-semantic-search-mcp",  // Replace with actual path
        "run",
        "main.py"
      ]
    }
  }
}

注意：将 /path/to/arxiv-semantic-search-mcp 替换为克隆仓库的实际路径。

可用函数

函数	描述
search_semantic	使用自然语言查询和嵌入语义搜索论文
search_keyword	使用包含多种筛选条件的结构化关键词查询搜索论文
get_details	根据 arXiv ID 获取特定论文的详细信息
get_categories	获取 arXiv 类别列表及其说明
get_current_time	获取指定格式的当前服务时间

详细文档和示例请参阅 src/server.py。

使用示例

语义搜索

# Search for papers about deep learning in computer vision
search_semantic(
    query="recent advances in vision transformers for medical image segmentation",
    categories=["cs.CV", "cs.AI"]
)

关键词搜索

# Search for recent machine learning papers in multiple categories
search_keyword(
    categories=["cs.AI", "cs.LG"],
    start_date="2024-01-01",
    all_fields="transformer",
    sort_by="submittedDate",
    sort_order="descending"
)

获取论文详情

# Get detailed information for a specific paper
get_details("2401.00001")

许可证

本项目根据 MIT 许可证发布。