@shelv/mcp 0.2.0

package/LICENSE

@@ -0,0 +1,15 @@
+Shelv MCP Proprietary License
+Copyright (c) 2026 Shelv. All rights reserved.
+
+Permission is not granted to use, copy, modify, merge, publish, distribute,
+sublicense, or sell this software or any derivative works, in whole or in part,
+except under a separate written agreement signed by Shelv.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. IN NO EVENT SHALL
+SHELV BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For licensing inquiries, contact: founders@shelv.dev

package/README.md

@@ -0,0 +1,55 @@
+# @shelv/mcp
+
+MCP server for Shelv shelf operations.
+
+## Install
+
+```bash
+pnpm add @shelv/mcp
+```
+
+```bash
+npm install @shelv/mcp
+```
+
+```bash
+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
+
+```bash
+shelv-mcp
+```
+
+```bash
+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`

package/dist/bin/shelv-mcp.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node