Skip to content
Back to search

lit-search-mcp

One MCP endpoint for literature search across OpenAlex, arXiv, PubMed, Crossref, Project Gutenberg, Open Library and Internet Archive, routed to the cyanheads MCP servers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/iprawiranegara--lit-search-mcp/badge.svg)](/listings/iprawiranegara--lit-search-mcp)

HTML

<a href="/listings/iprawiranegara--lit-search-mcp"><img src="/api/listings/iprawiranegara--lit-search-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Node.js 24 or later. No API keys are needed.

npm install -g github:iprawiranegara/lit-search-mcp
lit-search-stack

Check it:

curl http://127.0.0.1:28502/health

Run it in the background (Linux)

`examples/systemd/lit-search-mcp.service` is a systemd user unit. Edit the `ExecStart` paths, then:

cp examples/systemd/lit-search-mcp.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now lit-search-mcp.service

`loginctl enable-linger "$USER"` keeps it running after you log out. On Windows or macOS, run `lit-search-stack` from the platform's own startup mechanism (a logon scheduled task, a launchd user agent). Only the Linux setup has been tested.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 126 lines
  1. # lit-search-mcp
  2. One MCP endpoint for literature search across seven sources: OpenAlex, arXiv, PubMed, Crossref, Project Gutenberg, Open Library and the Internet Archive.
  3. lit-search-mcp is a router. The seven sources are served by MCP servers written by [cyanheads](https://github.com/cyanheads), which npm installs alongside the router. The router gives an agent six uniform tools and forwards each call to the right server.
  4. ## Credits
  5. The search work is done by these servers by cyanheads (Casey Hand), each under Apache-2.0:
  6. | Source | Package | Repository |
  7. |---|---|---|
  8. | OpenAlex | `@cyanheads/openalex-mcp-server` | <https://github.com/cyanheads/openalex-mcp-server> |
  9. | arXiv | `@cyanheads/arxiv-mcp-server` | <https://github.com/cyanheads/arxiv-mcp-server> |
  10. | PubMed | `@cyanheads/pubmed-mcp-server` | <https://github.com/cyanheads/pubmed-mcp-server> |
  11. | Crossref | `@cyanheads/crossref-mcp-server` | <https://github.com/cyanheads/crossref-mcp-server> |
  12. | Project Gutenberg | `@cyanheads/gutenberg-mcp-server` | <https://github.com/cyanheads/gutenberg-mcp-server> |
  13. | Open Library | `@cyanheads/openlibrary-mcp-server` | <https://github.com/cyanheads/openlibrary-mcp-server> |
  14. | Internet Archive | `@cyanheads/internet-archive-mcp-server` | <https://github.com/cyanheads/internet-archive-mcp-server> |
  15. lit-search-mcp does not copy or modify their code. It is an independent project and is not affiliated with or endorsed by cyanheads. If a source misbehaves, check whether the problem is in the upstream server before filing it there; see NOTICE.
  16. ## How it runs
  17. Eight processes: seven upstream servers, each on its own loopback port, and the router in front of them.
  18. ```
  19. MCP client(s) ──> router :28502/mcp ──> openalex :28495
  20. ├─> arxiv :28496
  21. ├─> pubmed :28497
  22. ├─> crossref :28498
  23. ├─> gutenberg :28499
  24. ├─> openlibrary :28500
  25. └─> internet-archive :28501
  26. ```
  27. All MCP clients on the machine (Claude Code, Codex, OpenCode, Hermes and so on) share one running set. Nothing is started per client session, so memory use stays flat as you add clients.
  28. The set is not small. Measured on Linux with Node 24, freshly started through `lit-search-stack`: each of the seven upstream servers takes about 150 MiB RSS, the router about 80 MiB and the launcher about 50 MiB, so about 1.2 GB in total, rising to about 1.3 GB after the first calls. On a laptop with little memory to spare, that is a real cost.
  29. The `lit-search-stack` command starts all eight, prefixes their log lines with the source name, and restarts any process that exits.
  30. ## Install
  31. Requires Node.js 24 or later. No API keys are needed.
  32. ```bash
  33. npm install -g github:iprawiranegara/lit-search-mcp
  34. lit-search-stack
  35. ```
  36. Check it:
  37. ```bash
  38. curl http://127.0.0.1:28502/health
  39. ```
  40. ### Run it in the background (Linux)
  41. `examples/systemd/lit-search-mcp.service` is a systemd user unit. Edit the `ExecStart` paths, then:
  42. ```bash
  43. cp examples/systemd/lit-search-mcp.service ~/.config/systemd/user/
  44. systemctl --user daemon-reload
  45. systemctl --user enable --now lit-search-mcp.service
  46. ```
  47. `loginctl enable-linger "$USER"` keeps it running after you log out. On Windows or macOS, run `lit-search-stack` from the platform's own startup mechanism (a logon scheduled task, a launchd user agent). Only the Linux setup has been tested.
  48. ## Connect a client
  49. Register the router as a remote Streamable HTTP server, by URL. Do not register the upstream servers individually.
  50. ```bash
  51. # Claude Code
  52. claude mcp add --transport http --scope user lit-search http://127.0.0.1:28502/mcp
  53. ```
  54. ```toml
  55. # Codex: ~/.codex/config.toml
  56. [mcp_servers.lit-search]
  57. url = "http://127.0.0.1:28502/mcp"
  58. ```
  59. ## Tools
  60. | Tool | What it does | Sources |
  61. |---|---|---|
  62. | `list_sources` | Coverage summary for each source | all |
  63. | `search_works` | Keyword search (`source`, `query`, optional `limit`, default 10) | all |
  64. | `get_work` | Metadata for one work by ID (DOI, PMID, arXiv ID, OpenAlex ID, ...) | all |
  65. | `get_references` | Works cited by a work | openalex, pubmed, crossref |
  66. | `get_citations` | Works that cite a work | openalex, pubmed |
  67. | `get_full_text` | Full text | arxiv, pubmed, gutenberg, internet-archive |
  68. Gutenberg search ignores `limit` and returns pages of up to 32 books.
  69. ## Configuration
  70. Everything is optional. Set variables in the shell or, with the systemd unit, in `~/.config/lit-search-mcp/env`. `examples/env.example` lists them all.
  71. | Variable | Default | Meaning |
  72. |---|---|---|
  73. | `LIT_SEARCH_HOST` | `127.0.0.1` | Host every process binds to and the router connects to |
  74. | `LIT_SEARCH_PORT` | `28502` | Router port |
  75. | `LIT_SEARCH_PATH` | `/mcp` | MCP endpoint path for all processes |
  76. | `LIT_SEARCH_PORT_<SOURCE>` | 28495 to 28501 | Port of one upstream, e.g. `LIT_SEARCH_PORT_INTERNET_ARCHIVE` |
  77. | `LIT_SEARCH_URL_<SOURCE>` | unset | Full URL of an upstream you run yourself; overrides host and port |
  78. The default ports sit below the ephemeral port ranges of Linux (32768 to 60999) and Windows and macOS (49152 to 65535), so an outgoing connection cannot take one of them first.
  79. The upstream servers read their own settings from the same environment. Two are worth setting: `CROSSREF_MAILTO` (a contact address puts Crossref requests in its polite pool) and `NCBI_API_KEY` with `NCBI_ADMIN_EMAIL` for PubMed. Each package's README documents the full list.
  80. ### Router only
  81. If you already run the upstream servers, start only the router with `lit-search-mcp` and point it at them with the `LIT_SEARCH_PORT_<SOURCE>` or `LIT_SEARCH_URL_<SOURCE>` variables.
  82. ## Behaviour notes
  83. - The router keeps one connection per upstream. If a call fails it reconnects once and retries, so an upstream restart costs one slower call, not an error.
  84. - The upstream versions are pinned in `package.json` to the versions this router was tested against. Newer cyanheads releases may rename tools or arguments; update the pins and the routing table in `index.mjs` together.
  85. - Errors from the remote services (rate limits, outages) come back as tool errors with the upstream message.
  86. ## License
  87. Apache License 2.0. See LICENSE and NOTICE.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.