AI导哈

arXiv论文搜索与解析服务

Paper MCP是一个专注于arXiv论文搜索和全文解析的轻量级服务，提供高效的学术文献检索与内容提取功能。

  • by DoraemonHugU
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 DoraemonHugU/thesisiknowbase

使用说明

纸张MCP

中文说明

Paper MCP是一个小型MCP服务器，专注于两个工具：

  • search_papers：搜索arXiv论文
  • read_paper：获取并解析全文内容

当前的生产传输是Streamable HTTP /mcp.

需求

  • Python 3.12+
  • uv

设置

uv sync

跑

uv run python run_server.py

作为工具安装：

uv tool install arxiv-mcp-paper-server
arxiv-paper-mcp

默认端点：

http://127.0.0.1:18181/mcp

MCP表面

search_papers

  • 必修的： query
  • 可选： max_results, date_from, date_to, categories, sort_by
  • 返回：纸质记录列表

read_paper

  • 必修的： paper_id
  • 返回：解析的论文内容和元数据

运输

  • 默认值：流式HTTP
  • 兼容传统模式：SSE

相关环境变量：

  • PAPER_MCP_TRANSPORT: http, streamable-http，或 sse
  • PAPER_HTTP_HOST
  • PAPER_HTTP_PORT
  • PAPER_HTTP_PATH
  • PAPER_MCP_PATH （MCP端点路径的可选别名）

使用 .env.example 作为本地和部署设置的单一环境模板。

运行时注意事项

  • 搜索目前使用arXiv API，并将纯自由文本查询保持为接近官方arXiv查询语义，而不是强制将它们放入内部短语包装器中。
  • 日期和类别选项附加为 submittedDate:[...] 和 cat:... 用户查询之上的过滤器。
  • 阅读流临时下载PDF，解析它们，然后删除PDF。
  • 公共MCP表面有意限制为两个工具。

开发说明

  • 使用 uv 用于依赖性管理和执行。
  • 主要入口点： run_server.py
  • 主服务器模块： src/paper_mcp/server.py

致谢

多亏了 blazickjp/arxiv-mcp-server，一个广泛使用的arXiv MCP项目，帮助塑造了人们对面向arXiv的MCP工具的期望。这个存储库采用了一种不同的实现路径，专注于最小的公共表面、官方arXiv查询传递语义和全文本地解析。

相关 MCP