MCP 服务器

Paper Reader MCP

Enables searching arXiv papers and retrieving full paper content as Markdown, with smart sorting, category filtering, and pagination.

README

Paper Reader MCP

一个基于 MCP (Model Context Protocol) 的 arXiv 论文搜索与阅读服务，带有 Web 管理界面和完整的认证机制。

功能

📚 论文搜索

工具	功能
`search_papers`	搜索 arXiv 论文（支持智能排序、分类过滤）
`get_paper_content`	获取论文全文（Markdown 格式，支持分页）

🔍 搜索功能特性

智能排序：综合相关性和时间，越相关且越新的排越前
分类过滤：支持 cs.AI、cs.LG、cs.CV、cs.CL 等分类
多种排序：相关性、提交时间、更新时间

📖 论文阅读特性

PDF 转 Markdown：自动下载并转换为易读的 Markdown 格式
分页返回：支持自定义每页字符数，适配 Token 限制
摘要显示：每次返回都包含论文摘要
智能缓存：自动缓存论文，超过 1GB 或 3 个月自动清理

🔐 认证功能

管理员登录（用户名/密码）
Session 会话管理
API Token 管理（供 MCP 客户端使用）

快速开始

1. 安装依赖并运行

./run.sh

或手动：

pip install -r requirements.txt
python3.11 server.py

2. 访问

Web 界面: http://localhost:8633
管理后台: http://localhost:8633/admin
MCP 端点: http://localhost:8633/mcp

3. 默认账号

用户名：admin
密码：admin123

请登录后在管理页面修改密码！

MCP 客户端配置

1. 创建 API Token

访问管理页面：http://localhost:8633/admin
在「API Token 管理」中创建新 Token
复制生成的 Token

2. 配置 Cursor / Claude Desktop

{
  "mcpServers": {
    "paper-reader": {
      "url": "http://localhost:8633/mcp",
      "headers": {
        "Authorization": "Bearer mcp_xxxxxxxx..."
      }
    }
  }
}

使用示例

搜索论文

# 智能搜索（默认：相关性+时间综合排序）
search_papers("transformer attention")

# 指定分类搜索
search_papers("large language model", category="cs.CL")

# 按时间排序
search_papers("diffusion model", sort_by="submitted", category="cs.CV")

获取论文全文

# 获取论文第一页（默认 20000 字符）
get_paper_content("1706.03762")

# 获取指定页
get_paper_content("1706.03762", page=2)

# 自定义每页字符数
get_paper_content("1706.03762", max_chars=50000)

常用分类

分类代码	说明	推荐用于
`cs.AI`	人工智能	通用 AI
`cs.CL`	计算语言学/NLP	LLM、文本处理
`cs.CV`	计算机视觉	图像、视频
`cs.LG`	机器学习	通用 ML 算法
`cs.NE`	神经网络	网络架构
`cs.IR`	信息检索	搜索、推荐系统
`cs.RO`	机器人	机器人技术
`stat.ML`	统计机器学习	统计方法
`eess.AS`	音频与语音	语音处理
`eess.IV`	图像与视频	信号处理

项目结构

paper_reader/
├── server.py              # 服务器入口（Web + MCP）
├── run.sh                 # 启动脚本
├── config.yaml            # 配置文件
├── requirements.txt       # 依赖列表
├── paper_tools/           # 论文工具模块
│   ├── arxiv_search.py    # arXiv 搜索
│   ├── paper_cache.py     # 缓存管理
│   └── pdf_converter.py   # PDF 转 Markdown
├── auth.py                # 认证模块
├── api_logger.py          # API 日志
├── templates/             # HTML 模板
│   ├── index.html         # 工具测试页面
│   ├── login.html         # 登录页面
│   ├── admin.html         # 管理页面
│   └── logs.html          # 日志页面
├── static/                # 静态资源
│   ├── css/
│   └── js/
└── data/                  # 数据目录
    ├── auth.db            # 认证数据库
    ├── api_logs.db        # API 日志
    └── papers/            # 论文缓存
        ├── pdf/           # PDF 文件
        └── markdown/      # Markdown 文件

配置说明

config.yaml

# 服务器配置
server:
  name: "Paper Reader MCP"
  port: 8633

# 认证配置
auth:
  default_password: "admin123"
  salt: "your_salt_here"

# 存储配置
storage:
  data_dir: "./data"

# 论文缓存配置
papers:
  max_size_mb: 1024      # 最大缓存 1GB
  max_age_days: 90       # 保留 3 个月