Skip to main content
Glama

@shelv/mcp

MCP server for Shelv shelf operations.

Related MCP server: Shelby docs MCP

Install

pnpm add @shelv/mcp
npm install @shelv/mcp
npx @shelv/mcp

Environment

  • SHELV_API_KEY for stdio mode

  • SHELV_MCP_TRANSPORT=stdio|http (defaults to stdio)

  • SHELV_MCP_HTTP_HOST (defaults to 127.0.0.1)

  • SHELV_MCP_HTTP_PORT (defaults to 3334)

  • SHELV_MCP_ENABLE_WRITE_TOOLS=true to enable create_shelf and hydrate_shelf

  • SHELV_MCP_SEARCH_MAX_FILES (defaults to 500)

  • SHELV_MCP_SEARCH_MAX_BYTES (defaults to 5000000)

  • SHELV_MCP_SEARCH_MAX_MATCHES (defaults to 200)

  • SHELV_MCP_READ_MAX_BYTES (defaults to 250000)

Run

shelv-mcp
SHELV_MCP_TRANSPORT=http SHELV_MCP_HTTP_PORT=3334 shelv-mcp

In HTTP mode, send Authorization: Bearer sk_... on each request unless SHELV_API_KEY is configured as a startup fallback.

Tools

  • list_shelves

  • get_shelf_tree

  • read_shelf_file

  • search_shelf

Write tools are disabled by default and become available only when SHELV_MCP_ENABLE_WRITE_TOOLS=true:

  • create_shelf

  • hydrate_shelf

License

Apache-2.0.

Available Tools

4 tools
get_shelf_treeGet Shelf TreeA
Read-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 ShelvesA
Read-only

List shelves available to the authenticated user

Inputs: page, limit. Returns: shelves, pagination

read_shelf_fileRead Shelf FileB
Read-only

Read a single file from a shelf

Inputs: shelf_id (required), path (required). Returns: path, bytes, content, shelf_id, +2 more

search_shelfSearch ShelfB
Read-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

    A3.8/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server providing filesystem operations, shell execution, and web search capabilities.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that enables searching books and authors, fetching editions, browsing subjects, and resolving cover images from Open Library.
      242 npm
      4
      Apache 2.0