rubien-mcp-server 0.1.0

package/dist/tools/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/tools/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,mMAAmM;QACrM,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAC7C,CAAC;AACJ,CAAC"}

package/dist/tools/views.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { flagsFromOptions, runCliAsTool } from "../toolHelpers.js";
+export function registerViewTools(server) {
+    server.registerTool("rubien_views_list", {
+        title: "List saved views",
+        description: "List saved database views (persisted filter/sort/group configurations). Returns DatabaseViewDTO[].",
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => runCliAsTool(["views"]));
+    server.registerTool("rubien_views_create", {
+        title: "Create saved view",
+        description: "Create a new saved view. filters / sorts / groupBy must be valid JSON matching the view configuration schema (mirrors what the GUI editor produces). Use rubien_views_list first to see the shape.",
+        inputSchema: {
+            name: z.string(),
+            filters: z
+                .string()
+                .optional()
+                .describe("JSON string: ViewFilter[]"),
+            sorts: z
+                .string()
+                .optional()
+                .describe("JSON string: ViewSort[]"),
+            groupBy: z
+                .string()
+                .optional()
+                .describe("JSON string: GroupConfig"),
+        },
+    }, async ({ name, filters, sorts, groupBy }) => runCliAsTool([
+        "views",
+        "--create",
+        ...flagsFromOptions({
+            "--name": name,
+            "--filters": filters,
+            "--sorts": sorts,
+            "--group-by": groupBy,
+        }),
+    ]));
+    server.registerTool("rubien_views_delete", {
+        title: "Delete saved view",
+        description: "Remove a saved view by ID.",
+        inputSchema: { id: z.number().int() },
+        annotations: { destructiveHint: true },
+    }, async ({ id }) => runCliAsTool(["views", "--delete", "--id", String(id)]));
+    server.registerTool("rubien_views_rename", {
+        title: "Rename saved view",
+        description: "Change a saved view's name.",
+        inputSchema: { id: z.number().int(), name: z.string() },
+    }, async ({ id, name }) => runCliAsTool([
+        "views",
+        "--rename",
+        "--id",
+        String(id),
+        "--name",
+        name,
+    ]));
+    server.registerTool("rubien_views_query", {
+        title: "Query a saved view",
+        description: "Run a saved view's filter/sort config and return the matching references. Equivalent to opening the view in the GUI.",
+        inputSchema: {
+            id: z.number().int(),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(1000)
+                .optional()
+                .describe("Result cap (default 100)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ id, limit }) => runCliAsTool([
+        "views",
+        "--query",
+        "--id",
+        String(id),
+        ...flagsFromOptions({ "--limit": limit }),
+    ]));
+}
+//# sourceMappingURL=views.js.map

package/dist/tools/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../src/tools/views.ts"],"names":[],"mappings":"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"}

package/dist/tools/web.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { flagsFromOptions, runCliAsTool } from "../toolHelpers.js";
+export function registerWebTools(server) {
+    server.registerTool("rubien_web_get", {
+        title: "Read the extracted body of a clipped web reference",
+        description: "Return the extracted readable text of a clipped web page reference that is already in the library. This is library-only — it does NOT fetch from the network; it returns the same text the in-app WebReader shows. Use `start` (character offset) and `maxChars` (default 50000) to paginate long pages — `contentLength` tells you the total decoded body length. The `contentFormat` field is `\"markdown\"` (most pages, post-extraction) or `\"html\"` (a small number of pages where the clipper preserved markup). For HTML, treat `content` as a fragment, not a full document. To see the user's highlights/notes on the page, call `rubien_web_annotations` for the same reference. Errors when the reference doesn't exist or has no web content (e.g. PDF-only references).",
+        inputSchema: {
+            referenceId: z.number().int().describe("Reference ID"),
+            maxChars: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Cap returned characters (default 50000). Truncation is at the character boundary."),
+            start: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .describe("Character offset into the decoded body (default 0). Past end-of-content returns content=\"\" with truncated=false."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async (args) => {
+        const cliArgs = ["web", "get", String(args.referenceId)];
+        cliArgs.push(...flagsFromOptions({
+            "--max-chars": args.maxChars,
+            "--start": args.start,
+        }));
+        return runCliAsTool(cliArgs);
+    });
+    server.registerTool("rubien_web_annotations", {
+        title: "List web-page annotations for a reference",
+        description: "Return the highlights, underlines, and anchored notes the user has made on a clipped web reference. This is the web-page counterpart to `rubien_annotations_list` (which covers PDF annotations only). Each annotation carries `anchorText` (the highlighted string — also what the sidebar displays), `noteText` (the user's attached note, if any), and `prefixText` / `suffixText` (the surrounding text that disambiguates the location). Together `prefixText` / `anchorText` / `suffixText` form a W3C TextQuoteSelector — use them to locate each highlight inside the body returned by `rubien_web_get`. Empty array when the reference has no web annotations or the reference ID doesn't exist (not an error).",
+        inputSchema: {
+            referenceId: z.number().int().describe("Reference ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ referenceId }) => runCliAsTool(["web", "annotations", String(referenceId)]));
+}
+//# sourceMappingURL=web.js.map

package/dist/tools/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/tools/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,oDAAoD;QAC3D,WAAW,EACT,wvBAAwvB;QAC1vB,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACtD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CACP,mFAAmF,CACpF;YACH,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,WAAW,EAAE;iBACb,QAAQ,EAAE;iBACV,QAAQ,CACP,oHAAoH,CACrH;SACJ;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,OAAO,GAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CACV,GAAG,gBAAgB,CAAC;YAClB,aAAa,EAAE,IAAI,CAAC,QAAQ;YAC5B,SAAS,EAAE,IAAI,CAAC,KAAK;SACtB,CAAC,CACH,CAAC;QACF,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,2CAA2C;QAClD,WAAW,EACT,0rBAA0rB;QAC5rB,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;SACvD;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CACxB,YAAY,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAC5D,CAAC;AACJ,CAAC"}

package/dist/versionGuard.js

@@ -0,0 +1,30 @@
+/**
+ * The minimum rubien-cli build this server requires. Equals the release build
+ * that first shipped the `version` subcommand. Bump only when a future server
+ * release genuinely needs a newer CLI feature; the released CLI's build must
+ * always be >= this value.
+ */
+export const MIN_CLI_BUILD = 8;
+const RELEASES = "https://github.com/devzhk/Rubien-releases/releases";
+/** Pure decision: is the discovered CLI new enough? `info` is null when the
+ *  CLI has no `version` subcommand (i.e. predates this mechanism). */
+export function evaluateCliVersion(info, minBuild) {
+    if (info === null) {
+        return {
+            ok: false,
+            message: `rubien-mcp-server: cannot determine rubien-cli version ` +
+                `(your rubien-cli predates the 'version' command). ` +
+                `Update Rubien.app (Mac) or download a newer rubien-cli from ${RELEASES} (Linux).`,
+        };
+    }
+    if (info.build < minBuild) {
+        return {
+            ok: false,
+            message: `rubien-mcp-server: installed rubien-cli is build ${info.build}, ` +
+                `but this server needs build >= ${minBuild}. ` +
+                `Update Rubien.app (Mac) or download a newer rubien-cli from ${RELEASES} (Linux).`,
+        };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=versionGuard.js.map

package/dist/versionGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionGuard.js","sourceRoot":"","sources":["../src/versionGuard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAY/B,MAAM,QAAQ,GAAG,oDAAoD,CAAC;AAEtE;sEACsE;AACtE,MAAM,UAAU,kBAAkB,CAChC,IAAuB,EACvB,QAAgB;IAEhB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,yDAAyD;gBACzD,oDAAoD;gBACpD,+DAA+D,QAAQ,WAAW;SACrF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,GAAG,QAAQ,EAAE,CAAC;QAC1B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,oDAAoD,IAAI,CAAC,KAAK,IAAI;gBAClE,kCAAkC,QAAQ,IAAI;gBAC9C,+DAA+D,QAAQ,WAAW;SACrF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "rubien-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server wrapping rubien-cli so Claude Code and claude.ai can manage the Rubien reference library.",
+  "license": "Apache-2.0",
+  "author": "devzhk",
+  "homepage": "https://github.com/devzhk/Rubien-releases#readme",
+  "repository": { "type": "git", "url": "git+https://github.com/devzhk/Rubien-releases.git" },
+  "bugs": { "url": "https://github.com/devzhk/Rubien-releases/issues" },
+  "keywords": ["mcp", "model-context-protocol", "rubien", "reference-manager", "citations"],
+  "type": "module",
+  "bin": {
+    "rubien-mcp-server": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}