Shelfmark MCP Server

by dankaro-projects Your server? Claim it

local only

Shelfmark runs on your own machine — the client starts it, so there is no endpoint to ping. 324 installs a week from pypi. Last commit 15 Aug 2026.

Local, privacy-first document catalogue for AI agents: metadata-only discovery, no cloud, no RAG.

The author archived this repository on GitHub, meaning it is no longer maintained.

Installs per day peak 156 · avg 33 · +133% w/w

a month agotoday

324

Installs / week

pypi · shelfmark

Stars

0 open issues

15 Aug 2026

Last commit

from GitHub

MIT

License

Python

What the code does

We read the source, 5 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Executes code built at runtime src/shelfmark/emails.py:536, [пакет] src/shelfmark/emails.py:536, src/shelfmark/doctor.py:254 и ещё 1

            __import__(module)

Touches key and credential files src/shelfmark/rules.py:77, [пакет] src/shelfmark/rules.py:77, site/src/pages/docs.astro:49

    r"|(^|/)(id_rsa|id_ed25519|id_ecdsa|id_dsa)(\.|$)"

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add shelfmark -- uvx shelfmark

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shelfmark": {
      "command": "uvx",
      "args": [
        "shelfmark"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.shelfmark]
command = "uvx"
args = ["shelfmark"]

.cursor/mcp.json

{
  "mcpServers": {
    "shelfmark": {
      "command": "uvx",
      "args": [
        "shelfmark"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "shelfmark": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shelfmark"
      ]
    }
  }
}

Alternatives to Shelfmark

same job, measured the same way

Engram

by hbarefoot

Local-first persistent memory for AI agents — SQLite + local embeddings, MCP-native, no cloud.

53 installs/wk local only

Memory Kernel

by artem362

Local-first memory for AI agents: SQLite FTS5, deterministic recall, no vector DB, no cloud.

118 installs/wk local only

Koma Core MCP

by swnotmetal

Protected RAG storage — agents discover public metadata, content only by access token.

30 installs/wk local only

Minirag MCP

by sfrangulov

Local-first RAG MCP server: hybrid search over a folder of your own documents

1 234 installs/wk local only

Continuum

by pouyahasanamreji

Shared memory + orchestration for your coding agents. Local-first MCP, vector RAG.

local only

Darwin RAG

by brightdotdev

Local-first RAG engine with MCP server for AI agent integration.

232 installs/wk local only

Documentation Search

by alyiox

Local RAG MCP for markdown documentation. Retrieval only; host synthesizes answers.

241 installs/wk local only

OmniClip RAG

by msjsc001

Read-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.

local only

Shelfmark — questions

Answers built from our own checks of this server.

Why is there no uptime for Shelfmark?

Shelfmark runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package shelfmark was installed 324 times last week.

Is Shelfmark still maintained?

The author archived this repository on GitHub, meaning it is no longer maintained. We show this because it changes what you can expect: an unmaintained server may keep answering for months and then stop without warning.

How do I connect Shelfmark?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls shelfmark straight from pypi; nothing to host, nothing to sign up for.

How many people use Shelfmark?

The pypi package shelfmark was installed 324 times in the last week. Week over week that is +133%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Shelfmark open source?

Yes — it is published under the MIT licence, written in Python and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.