Huggingface Daily Papers

HuggingFace Daily Papers MCP 服务

一个用于获取 HuggingFace 每日论文的 MCP（Model Context Protocol）服务。

功能

• 获取今天、昨天或指定日期的 HuggingFace 论文
• 提供论文标题、作者、摘要、标签、投票数和提交者信息
• 包含论文链接和 PDF 下载链接
• 支持 MCP 工具和资源接口
• 集成 ArXiv，获取完整作者列表
• 完善的错误处理和日志记录
• 全面的测试覆盖

安装与使用

选项 1：使用 uvx 直接运行（推荐）

使用 uvx 直接安装并运行：

uvx huggingface-daily-paper-mcp

此操作会自动安装软件包及其依赖项，然后启动 MCP 服务。

选项 2：本地开发

进行本地开发时，克隆代码仓库并安装依赖项：

git clone https://github.com/huangxinping/huggingface-daily-paper-mcp.git
cd huggingface-daily-paper-mcp
uv sync

本地使用命令

作为 MCP 服务运行（用于开发）：

python main.py

测试爬取函数：

python scraper.py

运行测试：

uv run -m pytest test_mcp_server.py -v

构建软件包：

uv build

MCP 接口

工具

1. get_papers_by_date

   • 描述：获取指定日期的 HuggingFace 论文
   • 参数：date（YYYY-MM-DD 格式）

2. get_today_papers

   • 描述：获取今天的 HuggingFace 论文
   • 参数：无

3. get_yesterday_papers

   • 描述：获取昨天的 HuggingFace 论文
   • 参数：无

资源

1. papers://today

   • 今天的论文 JSON 数据

2. papers://yesterday

   • 昨天的论文 JSON 数据

项目结构

huggingface-daily-paper-mcp/
├── main.py                    # MCP server main program
├── scraper.py                 # HuggingFace papers scraper module
├── test_mcp_server.py         # MCP server test cases
├── README.md                  # Project documentation
├── .gitignore                 # Git ignore file
├── pyproject.toml             # Project configuration file
└── uv.lock                    # Dependency lock file

技术栈

• Python 3.10+：编程语言
• MCP：Model Context Protocol 框架
• Requests：HTTP 请求库
• BeautifulSoup4：HTML 解析库
• pytest：测试框架
• uv：Python 软件包管理器

开发规范

• 使用 uv 原生命令管理软件包
• 遵循 Python PEP 8 编码规范
• 添加类型提示和文档字符串
• 完善错误处理和日志记录
• 编写单元测试以确保代码质量

示例输出

单篇论文的数据结构：

{
  "title": "CMPhysBench: A Benchmark for Evaluating Large Language Models in Condensed Matter Physics",
  "authors": ["Weida Wang", "Dongchen Huang", "Jiatong Li", "..."],
  "abstract": "CMPhysBench evaluates LLMs in condensed matter physics using calculation problems...",
  "url": "https://huggingface.co/papers/2508.18124",
  "pdf_url": "https://arxiv.org/pdf/2508.18124.pdf",
  "votes": 15,
  "submitted_by": "researcher123",
  "scraped_at": "2025-08-27T10:30:00.123456"
}

MCP 工具输出格式：

Title: CMPhysBench: A Benchmark for Evaluating Large Language Models in Condensed Matter Physics
Authors: Weida Wang, Dongchen Huang, Jiatong Li, Tengchao Yang, Ziyang Zheng...
Abstract: CMPhysBench evaluates LLMs in condensed matter physics using calculation problems...
URL: https://huggingface.co/papers/2508.18124
PDF: https://arxiv.org/pdf/2508.18124.pdf
Votes: 15
Submitted by: researcher123
--------------------------------------------------

AI IDE/CLI 配置

Claude Code（CLI）

添加到 MCP 配置中：

{
  "mcpServers": {
    "huggingface-papers": {
      "command": "uvx",
      "args": ["huggingface-daily-paper-mcp"]
    }
  }
}

Cursor IDE

添加到 .cursorrules 或 MCP 设置中：

{
  "mcp": {
    "servers": {
      "huggingface-papers": {
        "command": "uvx",
        "args": ["huggingface-daily-paper-mcp"],
        "env": {}
      }
    }
  }
}

Windsurf IDE

添加到 Windsurf MCP 配置中：

{
  "mcpServers": {
    "huggingface-papers": {
      "command": "uvx",
      "args": ["huggingface-daily-paper-mcp"]
    }
  }
}

使用 Continue Extension 的 VS Code

添加到 continue 配置中：

{
  "mcp": {
    "servers": {
      "huggingface-papers": {
        "command": "uvx",
        "args": ["huggingface-daily-paper-mcp"]
      }
    }
  }
}

其他兼容 MCP 的工具

对于任何兼容 MCP 的客户端，使用：

# Command
uvx huggingface-daily-paper-mcp

# Or with Python path
python -m main

许可证

MIT 许可证