Shelv MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Shelv MCP Server search for 'database' in my project shelf"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@shelv/mcp
MCP server for Shelv shelf operations.
Links
Website: shelv.dev
Source: github.com/shelv-dev/shelv-mcp
Related MCP server: Shelby docs MCP
Install
pnpm add @shelv/mcpnpm install @shelv/mcpnpx @shelv/mcpEnvironment
SHELV_API_KEYfor stdio modeSHELV_MCP_TRANSPORT=stdio|http(defaults tostdio)SHELV_MCP_HTTP_HOST(defaults to127.0.0.1)SHELV_MCP_HTTP_PORT(defaults to3334)SHELV_MCP_ENABLE_WRITE_TOOLS=trueto enablecreate_shelfandhydrate_shelfSHELV_MCP_SEARCH_MAX_FILES(defaults to500)SHELV_MCP_SEARCH_MAX_BYTES(defaults to5000000)SHELV_MCP_SEARCH_MAX_MATCHES(defaults to200)SHELV_MCP_READ_MAX_BYTES(defaults to250000)
Run
shelv-mcpSHELV_MCP_TRANSPORT=http SHELV_MCP_HTTP_PORT=3334 shelv-mcpIn HTTP mode, send Authorization: Bearer sk_... on each request unless
SHELV_API_KEY is configured as a startup fallback.
Tools
list_shelvesget_shelf_treeread_shelf_filesearch_shelf
Write tools are disabled by default and become available only when
SHELV_MCP_ENABLE_WRITE_TOOLS=true:
create_shelfhydrate_shelf
License
Apache-2.0.
Available Tools
4 toolsget_shelf_treeGet Shelf TreeARead-only
Get the full file tree and file contents for a shelf
Inputs: shelf_id (required). Returns: name, files, shelf_id, file_count
list_shelvesList ShelvesARead-only
List shelves available to the authenticated user
Inputs: page, limit. Returns: shelves, pagination
read_shelf_fileRead Shelf FileBRead-only
Read a single file from a shelf
Inputs: shelf_id (required), path (required). Returns: path, bytes, content, shelf_id, +2 more
search_shelfSearch ShelfBRead-only
Search for text across files in a shelf
Inputs: shelf_id (required), query (required), mode, case_sensitive, +1 more. Returns: mode, query, matches, shelf_id, +4 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: list_shelves enumerates available shelves, get_shelf_tree retrieves a full shelf's structure and contents, read_shelf_file accesses a single file, and search_shelf performs text searches across files. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., list_shelves, get_shelf_tree, read_shelf_file, search_shelf). The naming is predictable and readable, with verbs like 'list', 'get', 'read', and 'search' appropriately describing the actions.
With 4 tools, the server is well-scoped for its purpose of managing shelves and files. Each tool serves a distinct and necessary function, covering listing, retrieval, reading, and searching without being overly sparse or bloated.
The toolset provides strong coverage for core operations like listing, reading, and searching shelves and files. However, there are minor gaps in CRUD/lifecycle coverage, such as no tools for creating, updating, or deleting shelves or files, which agents might need to work around for full management tasks.
Maintenance
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
MCP server for Russian books search, details, and recommendation candidates.
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA generic MCP server that exposes local repository checkouts, allowing users to search and read code and documentation through natural language. It supports multiple instances, enabling seamless interaction with various codebases via configurable tool prefixes and URI schemes.1,950 npmMIT
- AlicenseBqualityDmaintenanceA read-only MCP server that provides searchable access to the Shelby documentation bundle for MCP-compatible clients. It enables users to search, list, and read documentation pages directly within AI tools and IDEs.4MIT
- FlicenseNot gradedqualityDmaintenanceMCP server providing filesystem operations, shell execution, and web search capabilities.-
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables searching books and authors, fetching editions, browsing subjects, and resolving cover images from Open Library.242 npm4Apache 2.0