mcpField
S
setup-arxiv-mcp

setup-arxiv-mcp

github.com/neolabhq生产力1.8k1.2k 次安装9 周前更新
代码仓库

关于 setup-arxiv-mcp

引导用户通过 Docker MCP 添加 `paper-search` MCP 服务，并将配置记录到 CLAUDE.md；也说明可选的 `arxiv-mcp-server` 设置，适用于需要其额外功能的情况。

主要功能

  1. 01选择项目共享、个人或全局配置
  2. 02检查 Docker MCP 是否可用
  3. 03查找并启用 `paper-search`
  4. 04使用 MCP 工具测试论文搜索
  5. 05将设置记录到指定的 CLAUDE.md
  6. 06配置 `arxiv-mcp-server` 作为替代方案

适用场景

  1. 01为项目配置学术论文搜索
  2. 02选择本地保留或团队共享 MCP 配置
  3. 03启用后验证 paper-search 服务
  4. 04为 `arxiv-mcp-server` 设置存储路径

MCP 相关

引导 Docker MCP 用户查找、添加、启用并测试 `paper-search` 服务，也提供可选的 `arxiv-mcp-server` 设置步骤。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/neolabhq/context-engineering-kit --skill setup-arxiv-mcp

安装后在 Claude Code 中输入/setup-arxiv-mcp确认已加载。

详细介绍

用户输入：

$ARGUMENTS

通过 Docker MCP 设置 arXiv MCP 服务指南

1. 确定设置范围

询问用户希望将配置存储在哪里：

选项：

  1. 项目级（通过 git 共享） - 配置纳入版本控制，与团队共享

    • CLAUDE.md 更新至：./CLAUDE.md

  2. 项目级（个人偏好） - 配置保留在本地，不纳入 git 跟踪

    • CLAUDE.md 更新至：./CLAUDE.local.md
    • 确认这些文件已列在 .gitignore 中；如果没有，则添加

  3. 用户级（全局） - 配置适用于该用户的所有项目

    • CLAUDE.md 更新至：~/.claude/CLAUDE.md

保存用户的选择，并在后续步骤中使用相应的路径。

2. 检查 Docker MCP 是否可用

首先，尝试使用 mcp-find 工具搜索服务，确认能否访问 Docker MCP (MCP_DOCKER)。

如果 Docker MCP 不可用：

  1. 请用户按照以下说明安装 Docker Desktop：https://docs.docker.com/desktop/
  2. 安装 Docker Desktop 后，指导用户按照以下说明连接 MCP：https://docs.docker.com/ai/mcp-catalog-and-toolkit/get-started/#claude-code
  3. 配置完成后，请用户重启 Claude Code，并运行“continue”以继续设置

3. 搜索并添加 paper-search MCP 服务

告知用户，常规的 arxiv-mcp-server 已知存在问题，具体表现为初始化失败（初始化过程中出现 EOF 错误）。因此我们将改用 paper-search MCP 服务。

使用 Docker MCP 查找并添加 paper-search MCP 服务，该服务提供全面的学术论文搜索功能：

mcp-find query: "paper-search"
mcp-add name: "paper-search" activate: true

该服务可访问多个学术来源：

  • arXiv - 物理、数学、计算机科学等领域的预印本
  • PubMed - 生物医学文献
  • bioRxiv/medRxiv - 生物学和医学预印本
  • Semantic Scholar - AI 驱动的研究工具
  • Google Scholar - 广泛的学术搜索
  • IACR - 密码学研究
  • CrossRef - 基于 DOI 的引用数据库

4. 测试设置

通过搜索论文来确认服务运行正常：

mcp-exec name: "search_arxiv" arguments: {"query": "test query", "max_results": 2}

5. 更新 CLAUDE.md 文件

使用第 1 步确定的路径：

paper-search MCP 服务成功设置后，使用以下内容更新 CLAUDE.md 文件：

### Use Paper Search MCP for Academic Research

Paper Search MCP is available via Docker MCP for searching and downloading academic papers.

**Available tools**:

- `search_arxiv` - Search arXiv preprints (physics, math, CS, etc.)
- `search_pubmed` - Search PubMed biomedical literature
- `search_biorxiv` / `search_medrxiv` - Search biology/medicine preprints
- `search_semantic` - Search Semantic Scholar with year filters
- `search_google_scholar` - Broad academic search
- `search_iacr` - Search cryptography papers
- `search_crossref` - Search by DOI/citation

**Download and read tools**:

- `download_arxiv` / `read_arxiv_paper` - Download/read arXiv PDFs
- `download_biorxiv` / `read_biorxiv_paper` - Download/read bioRxiv PDFs
- `download_semantic` / `read_semantic_paper` - Download/read via Semantic Scholar

**Usage notes**:

- Use `mcp-exec` to call tools, e.g., `mcp-exec name: "search_arxiv" arguments: {"query": "topic", "max_results": 10}`
- Downloaded papers are saved to `./downloads` by default
- For Semantic Scholar, supports multiple ID formats: DOI, ARXIV, PMID, etc.

6. 替代方案：arxiv-mcp-server

如果你特别需要具有额外功能（深度分析提示词、本地存储管理）的专用 arXiv MCP 服务，可以尝试：

mcp-find query: "arxiv"
mcp-config-set server: "arxiv-mcp-server" key: "storage_path" value: "/path/to/papers"
mcp-add name: "arxiv-mcp-server" activate: true

注意：此服务需要配置已下载论文的存储路径。

评论

支持 Markdown