mcpField
S
setup

setup

github.com/fcakyonProductivity1.2k97 installsUpdated today
Repository

About setup

A setup skill for installing and verifying Paper Search CLI, including source access, credentials, upgrades, and migration away from an obsolete MCP plugin. It is for users preparing CLI-based paper search without an MCP server.

Key features

  1. 01Install Paper Search CLI with uv
  2. 02Verify sources and search results
  3. 03Configure provider credentials
  4. 04Upgrade the CLI
  5. 05Remove obsolete MCP registration

Use cases

  1. 01Set up paper search on a new environment
  2. 02Check that a provider search succeeds
  3. 03Configure credentials for restricted sources
  4. 04Move from the old MCP plugin to CLI commands

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fcakyon/claude-codex-settings --skill setup

After installing, type/setupin Claude Code to confirm it loaded.

Details

From the project README

Set up Paper Search CLI

Use fcakyon/paper-search-cli for paper searches, DOI lookup, PDF downloads, and text extraction. It requires uv and Python 3.10+; Docker and an MCP server are unnecessary.

  1. Run uv --version. If missing, follow the uv installation instructions.

  2. Install the CLI:

    uv tool install 'git+https://github.com/fcakyon/paper-search-cli'

  3. Run paper-search --help and paper-search sources. If the command is not on PATH, run uv tool update-shell and open a new shell.

  4. Check a public source:

    paper-search search 'object detection' -s crossref -n 3

Inspect the JSON errors field before declaring the search successful. An empty result or a provider error does not confirm working access.

For updates, run uv tool upgrade paper-search-cli.

Credentials

Use the CLI's .env.example for provider keys. Its current configuration path is ~/.config/paper-search-mcp/.env; the legacy path and PAPER_SEARCH_MCP_* names remain supported. Do not print secret values.

IEEE, Scopus, and Web of Science need credentials. Scopus and Web of Science require explicit source selection. Unpaywall needs an email. Metadata access does not guarantee access to a PDF.

Migrate from the MCP plugin

This plugin no longer registers the Docker MCP server. Reload the updated plugin to discard its old registration. If the user separately configured a paper-search MCP entry, identify that entry and remove it only when requested; preserve other servers. Run CLI commands directly without waiting for an MCP connection.

Comments

Markdown supported