@rozek/sds-mcp-server-loro 0.0.10

package/LICENSE.md

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2026-present Andreas Rozek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS 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.

package/README.md

@@ -0,0 +1,106 @@
+# @rozek/sds-mcp-server-loro
+
+MCP (Model Context Protocol) server for the **shareable-data-store** (SDS) family, using the **Loro** CRDT backend. Exposes all SDS store and entry operations as MCP tools so that AI agents can manage CRDT stores, entries, items, links, tokens, and batch workflows through the standard MCP tool-calling interface.
+
+Built on top of `@rozek/sds-mcp-server`.
+
+---
+
+## Prerequisites
+
+| requirement | details |
+| --- | --- |
+| **Node.js 22.5+** | required to run `sds-mcp-server-loro`. Download from [nodejs.org](https://nodejs.org). |
+| **MCP client** | any host that speaks the Model Context Protocol (Claude Desktop, custom agent, etc.) |
+| **SDS server** | only required for network operations (`sds_store_sync`, `sds_store_ping`, `sds_token_issue`). All local read/write tools work entirely offline. |
+| **JWT tokens** | server operations need a client token (scope `read` or `write`) or an admin token (scope `admin`). |
+
+All clients and servers connected to the same relay must use the **same CRDT backend**. Use `@rozek/sds-mcp-server-loro` together with `@rozek/sds-websocket-server` and `@rozek/sds-command-loro`.
+
+SQLite support is built directly into Node.js 22.5+ — no native addon and no build toolchain is needed.
+
+> **Note:** Run `pnpm build` (or `npm run build`) in this package directory before starting the server for the first time. The `dist/` directory is not included in the repository.
+
+---
+
+## Installation
+
+```bash
+pnpm add @rozek/sds-mcp-server-loro
+```
+
+Or use without installation via npx:
+
+```bash
+npx @rozek/sds-mcp-server-loro
+```
+
+---
+
+## Running without Installation
+
+Register the server in your MCP host configuration using `npx` as the command:
+
+**Claude Desktop (`claude_desktop_config.json`):**
+
+```json
+{
+  "mcpServers": {
+    "sds": {
+      "command": "npx",
+      "args": [ "-y", "@rozek/sds-mcp-server-loro" ]
+    }
+  }
+}
+```
+
+---
+
+## Configuration
+
+### Server-level defaults
+
+You can pre-configure default values for `StoreId`, `PersistenceDir`, `ServerURL`, `Token`, and `AdminToken` so that individual tool calls do not need to repeat them.
+
+**CLI arguments:**
+
+| argument | applies to |
+| --- | --- |
+| `--store <id>` | default `StoreId` for all tools |
+| `--data-dir <path>` | default `PersistenceDir` for all tools |
+| `--server <url>` | default `ServerURL` for sync/token tools |
+| `--token <jwt>` | default client `Token` for sync tools |
+| `--admin-token <jwt>` | default `AdminToken` for `sds_token_issue` |
+
+**Environment variables:**
+
+| variable | applies to |
+| --- | --- |
+| `SDS_STORE_ID` | default `StoreId` for all tools |
+| `SDS_DATA_DIR` | default `PersistenceDir` for all tools |
+| `SDS_SERVER_URL` | default `ServerURL` for sync/token tools |
+| `SDS_TOKEN` | default client `Token` for sync tools |
+| `SDS_ADMIN_TOKEN` | default `AdminToken` for `sds_token_issue` |
+
+**Precedence** (highest to lowest): tool parameter → CLI argument → environment variable → built-in default (`~/.sds` for `PersistenceDir`).
+
+---
+
+## Tools
+
+See `@rozek/sds-mcp-server` for the complete tool reference. All 20 tools available in `sds-mcp-server-loro` are identical to those in `sds-mcp-server` — the only difference is the CRDT backend used to store and synchronise data.
+
+| category | tools |
+| --- | --- |
+| **store** | `sds_store_info`, `sds_store_ping`, `sds_store_sync`, `sds_store_destroy`, `sds_store_export`, `sds_store_import` |
+| **entry** | `sds_entry_create`, `sds_entry_get`, `sds_entry_list`, `sds_entry_update`, `sds_entry_move`, `sds_entry_delete`, `sds_entry_restore`, `sds_entry_purge` |
+| **trash** | `sds_trash_list`, `sds_trash_purge_all`, `sds_trash_purge_expired` |
+| **tree** | `sds_tree_show` |
+| **token** | `sds_token_issue` |
+| **batch** | `sds_batch` |
+
+---
+
+## License
+
+[MIT License](../../LICENSE.md) © Andreas Rozek

package/dist/sds-mcp-server-loro.d.ts

@@ -0,0 +1 @@
+export { }

package/dist/sds-mcp-server-loro.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env -S node --no-warnings
+import { SDS_DataStore as o } from "@rozek/sds-core-loro";
+import { runMCPServer as s } from "@rozek/sds-mcp-server";
+const e = "0.0.10", t = {
+  version: e
+}, c = {
+  fromScratch: () => o.fromScratch(),
+  fromBinary: (r) => o.fromBinary(r)
+};
+s(c, "sds-mcp-server-loro", t.version).catch((r) => {
+  process.stderr.write(
+    `sds-mcp-server-loro: fatal: ${r.message ?? r}
+`
+  ), process.exit(1);
+});

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@rozek/sds-mcp-server-loro",
+  "description": "MCP server for shareable-data-store (Loro CRDT backend)",
+  "version": "0.0.10",
+  "keywords": [
+    "crdt",
+    "loro",
+    "mcp",
+    "model-context-protocol",
+    "shareable-data-store"
+  ],
+  "author": "Andreas Rozek",
+  "homepage": "https://github.com/rozek/shareable-data-store#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rozek/shareable-data-store.git",
+    "directory": "packages/sds-mcp-server-loro"
+  },
+  "bugs": {
+    "url": "https://github.com/rozek/shareable-data-store/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.5"
+  },
+  "type": "module",
+  "main": "./dist/sds-mcp-server-loro.js",
+  "module": "./dist/sds-mcp-server-loro.js",
+  "types": "./dist/sds-mcp-server-loro.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/sds-mcp-server-loro.js",
+      "types": "./dist/sds-mcp-server-loro.d.ts"
+    }
+  },
+  "bin": {
+    "sds-mcp-server-loro": "./dist/sds-mcp-server-loro.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@rozek/sds-mcp-server": "0.0.10",
+    "@rozek/sds-core-loro": "0.0.10"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.0.0",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}