关于 setup
用于安装和验证 Paper Search CLI 的配置技能,涵盖来源检查、凭据、升级及从旧 MCP 插件迁移。适合希望通过命令行检索论文、无需 MCP 服务的用户。
主要功能
- 01使用 uv 安装 Paper Search CLI
- 02验证来源与搜索结果
- 03配置提供商凭据
- 04升级命令行工具
- 05移除旧 MCP 注册
适用场景
- 01在新环境配置论文搜索
- 02检查提供商搜索是否成功
- 03为受限来源配置凭据
- 04从旧 MCP 插件迁移到命令行
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ fcakyon/ claude-codex-settings --skill setup安装后在 Claude Code 中输入/setup确认已加载。
详细介绍
设置 Paper Search CLI
使用 fcakyon/paper-search-cli 搜索论文、查询 DOI、下载 PDF 并提取文本。它需要 uv 和 Python 3.10+;无需 Docker 或 MCP 服务。
-
运行
uv --version。如果未安装,请按照 uv 安装说明操作。 -
安装 CLI:
uv tool install 'git+https://github.com/fcakyon/paper-search-cli' -
运行
paper-search --help和paper-search sources。如果命令不在 PATH 中,请运行uv tool update-shell并打开新的 shell。 -
检查一个公共来源:
paper-search search 'object detection' -s crossref -n 3
在确认搜索成功前,先检查 JSON 的 errors 字段。结果为空或提供方报错,都不能证明访问正常。
如需更新,请运行 uv tool upgrade paper-search-cli。
凭据
使用 CLI 的 .env.example 配置提供方密钥。当前配置路径为 ~/.config/paper-search-mcp/.env;旧路径和 PAPER_SEARCH_MCP_* 名称仍受支持。请勿输出密钥值。
IEEE、Scopus 和 Web of Science 需要凭据。Scopus 和 Web of Science 需要明确选择来源。Unpaywall 需要电子邮箱。可以访问元数据并不代表可以访问 PDF。
从 MCP 插件迁移
此插件不再注册 Docker MCP 服务。重新加载更新后的插件,以移除旧注册。如果用户单独配置了 paper-search MCP 条目,请找到该条目,并仅在用户提出请求时将其删除;保留其他服务。直接运行 CLI 命令,无需等待 MCP 连接。