@shelv/mcp

MCP server for Shelv shelf operations.

Links

• Website: shelv.dev

• Docs: docs.shelv.dev/guides/mcp-server

• npm: npmjs.com/package/@shelv/mcp

• Source: github.com/shelv-dev/shelv-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.