Arxiv Scout (Shimenghuang)

arxiv侦察兵

Claude Code MCP服务器，根据研究机会获取、分析和排名每日arxiv预印本，并根据您的工作进行个性化设置。

运作原理

1. 获取 -点击arxiv API，在您配置的类别中获取今天的论文，关键字过滤它们，并将结果缓存在SQLite中（当天重新运行是即时的）。
2. 简介 --读取您的配置，并可选择抓取您的谷歌学术页面上过去的论文标题，以提高相关性排名。
3. 分析 -准备一个结构化提示并将其交给ClaudeCode（您已经打开了它），因此不需要单独的LLM API调用。
4. 排名 --根据新颖性得分对克劳德的分析进行排序，并呈现一份清晰的降价报告。

设置

1.克隆并安装

带紫外线 （推荐--自动处理依赖关系和MCP注册）：

git clone https://github.com/shimenghuang/arxiv-scout
cd arxiv-scout
uv sync

安装紫外线： docs.astral.sh/uv

使用pip （需要手动注册MCP——见步骤2b）：

git clone https://github.com/shimenghuang/arxiv-scout
cd arxiv-scout
pip install mcp pyyaml

2a。在Claude Code中打开项目（uv用户）

claude

该项目包括 .mcp.json 自动注册arxiv侦察MCP服务器。Claude Code会在第一次打开时提示您信任服务器——批准它。

2b。手动注册MCP服务器（pip用户）

claude mcp add arxiv-scout python /path/to/arxiv-scout/mcp_server/server.py

然后在Claude Code中打开项目目录。

3.配置您的个人资料

选项A——互动式（推荐）： 在Claude Code中运行设置技能：

/scout-setup

这将引导您设置学者URL、arxiv类别、关键字和排名偏好。设置已保存到 ~/.claude-plugin-config/arxiv-scout/ 并在更新过程中持续存在。

选项B——直接编辑（仅限git clone用户）： 打开 config/user_profile.yaml 和 config/settings.yaml 在克隆的仓库中直接编辑它们。不需要设置技能。

4.跑步

/scout

没有日期， /scout 获取arxiv中可用的最新论文，不使用日期过滤器。通过一个日期来侦察特定的一天——只有在该日期前一个工作日提交的论文才会被退回：

/scout 2026-03-31

______________________________________________________________________

克劳德代码市场 --arxiv scout也可以通过Claude Code插件市场安装。这尚未经过充分测试，可能需要手动注册MCP服务器。欢迎反馈。 ``bash claude plugin marketplace add https://github.com/shimenghuang/arxiv-scout claude plugin install arxiv-scout@shimenghuang-arxiv-scout ``

项目结构

arxiv-scout/
├── .mcp.json                       ← auto-registers the MCP server with Claude Code
├── .claude/
│   ├── settings.json               ← pre-approves MCP tool calls (no per-step prompts)
│   └── skills/
│       ├── scout/SKILL.md          ← /scout skill definition
│       └── scout-setup/SKILL.md   ← /scout-setup skill definition
├── mcp_server/
│   ├── server.py                   ← MCP server (stdio transport)
│   └── tools/
│       ├── arxiv.py                ← arxiv API fetch + SQLite cache
│       ├── scholar.py              ← Google Scholar profile parser
│       └── analysis.py            ← prompt builder + report formatter
├── prompts/
│   └── analyze.md                  ← analysis prompt template
├── config/                         ← fallback config (overridden by ~/.claude-plugin-config/arxiv-scout/)
│   ├── user_profile.yaml
│   └── settings.yaml
└── data/                           ← created at runtime (gitignored)
    ├── cache.db                    ← arxiv SQLite cache
    └── reports/                    ← saved markdown reports

备注

• 谷歌学者抓取 有时由于机器人检测而失败——这是意料之中的。该工具优雅地回归到仅关键字相关性评分。学者数据缓存30天（可在中配置 settings.yaml).
• arxiv缓存 是按日期计算的，因此正在运行 /scout 在同一天多次不会重新使用arxiv API。删除 data/cache.db 强行重新取回。
• 令牌使用情况 --分析是由您已经打开的Claude Code模型完成的。没有额外的API帐单超出您的正常克劳德代码使用。