纸张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/mcpMCP表面
search_papers
- 必修的:
query - 可选:
max_results,date_from,date_to,categories,sort_by - 返回:纸质记录列表
read_paper
- 必修的:
paper_id - 返回:解析的论文内容和元数据
运输
- 默认值:流式HTTP
- 兼容传统模式:SSE
相关环境变量:
PAPER_MCP_TRANSPORT:http,streamable-http,或ssePAPER_HTTP_HOSTPAPER_HTTP_PORTPAPER_HTTP_PATHPAPER_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查询传递语义和全文本地解析。
