rubien-mcp-server 0.1.0

package/dist/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { createServer } from "node:http";
+import { parseArgs } from "node:util";
+import { randomUUID } from "node:crypto";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { buildServer } from "./server.js";
+import { requireBearer } from "./auth.js";
+import { getCliVersion } from "./cli.js";
+import { MIN_CLI_BUILD, evaluateCliVersion } from "./versionGuard.js";
+const USAGE = `Usage:
+  rubien-mcp-server [--stdio]
+  rubien-mcp-server --http --port <port> --bearer-token <token>
+
+Options:
+  --stdio              Start in stdio mode (default; use from Claude Code via \`claude mcp add\`).
+  --http               Start an HTTP server (use with Cloudflare Tunnel for claude.ai).
+  --port <n>           Port for HTTP mode (default 4000). Env: RUBIEN_MCP_PORT.
+  --bearer-token <t>   Required bearer token for HTTP mode. Env: RUBIEN_MCP_BEARER.
+  --help               Show this message.
+
+Examples:
+  # Claude Code
+  claude mcp add rubien node /path/to/mcp-server/dist/index.js
+
+  # claude.ai (remote MCP)
+  RUBIEN_MCP_BEARER=$(openssl rand -hex 32) \\
+    node dist/index.js --http --port 4000 --bearer-token "$RUBIEN_MCP_BEARER"
+  # then: cloudflared tunnel --url http://localhost:4000
+`;
+function parseCliArgs(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            stdio: { type: "boolean" },
+            http: { type: "boolean" },
+            port: { type: "string" },
+            "bearer-token": { type: "string" },
+            help: { type: "boolean" },
+        },
+        allowPositionals: false,
+    });
+    if (values.help) {
+        process.stdout.write(USAGE);
+        process.exit(0);
+    }
+    const mode = values.http ? "http" : "stdio";
+    const port = Number(values.port ?? process.env.RUBIEN_MCP_PORT ?? "4000");
+    const bearerToken = values["bearer-token"] ??
+        process.env.RUBIEN_MCP_BEARER;
+    if (mode === "http") {
+        if (!bearerToken) {
+            process.stderr.write("--bearer-token (or RUBIEN_MCP_BEARER env) is required in --http mode\n");
+            process.exit(2);
+        }
+        if (!Number.isFinite(port) || port <= 0 || port > 65535) {
+            process.stderr.write(`invalid --port: ${port}\n`);
+            process.exit(2);
+        }
+    }
+    return { mode, port, bearerToken };
+}
+async function runStdio() {
+    const server = buildServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // MCP stdio transport keeps the process alive via stdin.
+}
+async function runHttp(port, bearerToken) {
+    const server = buildServer();
+    // Stateful single-session transport. We generate a new session ID per
+    // connection — single-user personal use doesn't need stateless.
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+    });
+    await server.connect(transport);
+    const httpServer = createServer(async (req, res) => {
+        // Public unauthenticated paths: nothing.
+        if (!requireBearer(req, res, bearerToken))
+            return;
+        try {
+            await transport.handleRequest(req, res);
+        }
+        catch (err) {
+            process.stderr.write(`handleRequest failed: ${err.message}\n`);
+            if (!res.writableEnded) {
+                res.writeHead(500, { "content-type": "application/json" });
+                res.end('{"error":"internal transport error"}');
+            }
+        }
+    });
+    await new Promise((resolve) => httpServer.listen(port, resolve));
+    process.stderr.write(`rubien-mcp-server listening on http://127.0.0.1:${port}\n`);
+}
+async function main() {
+    const args = parseCliArgs(process.argv.slice(2));
+    // Version guard: probe the resolved CLI once, before connecting any
+    // transport. `--help` already exited inside parseCliArgs, so help works
+    // even with no CLI installed.
+    const guard = evaluateCliVersion(await getCliVersion(), MIN_CLI_BUILD);
+    if (!guard.ok) {
+        // Set exitCode + return rather than process.exit(1): the async stderr
+        // write to a pipe can truncate if we exit immediately. No transport is
+        // connected and the probe child has finished, so the event loop drains
+        // and the process exits with code 1 after stderr flushes.
+        process.stderr.write((guard.message ?? "rubien-cli version check failed") + "\n");
+        process.exitCode = 1;
+        return;
+    }
+    if (args.mode === "stdio") {
+        await runStdio();
+    }
+    else {
+        await runHttp(args.port, args.bearerToken);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`fatal: ${err.stack ?? err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schemas.js

@@ -0,0 +1,166 @@
+import { z } from "zod";
+// -----------------------------------------------------------------------------
+// Zod schemas mirroring the DTO structs in Sources/RubienCLI/RubienCLI.swift.
+//
+// Convention (load-bearing — a drift here silently breaks tool parsing):
+//   - Swift `let x: T?` (regular Optional) → `.optional()` in zod.
+//     Swift's JSONEncoder *omits* nil-valued optionals from output entirely,
+//     so `.nullable()` would fail to parse real CLI output.
+//   - `AlwaysEncodedOptional<T>` (e.g. DatabaseViewDTO.groupBy) → `.nullable()`.
+//     That wrapper forces an explicit `null` emission when nil.
+// -----------------------------------------------------------------------------
+const isoDateString = z
+    .string()
+    .describe("ISO-8601 timestamp with millisecond precision, e.g. 2026-04-24T12:00:00.000Z");
+export const CustomPropertyValueDTO = z.object({
+    propertyId: z.string(),
+    name: z.string(),
+    type: z.string(),
+    value: z.string(),
+});
+export const ReferenceDTO = z.object({
+    id: z.number().int().optional(),
+    title: z.string(),
+    authors: z.string(),
+    year: z.number().int().optional(),
+    journal: z.string().optional(),
+    volume: z.string().optional(),
+    issue: z.string().optional(),
+    pages: z.string().optional(),
+    doi: z.string().optional(),
+    url: z.string().optional(),
+    siteName: z.string().optional(),
+    abstract: z.string().optional(),
+    referenceType: z.string(),
+    dateAdded: isoDateString,
+    dateModified: isoDateString,
+    pdfPath: z.string().optional(),
+    notes: z.string().optional(),
+    isbn: z.string().optional(),
+    issn: z.string().optional(),
+    publisher: z.string().optional(),
+    language: z.string().optional(),
+    edition: z.string().optional(),
+    readingStatus: z.string(),
+    // Reader activity (v4). `lastReadAt` is a Swift `Date?` and is omitted from
+    // CLI output when the reference has never been opened — `.optional()`, not
+    // `.nullable()` (see header comment). `readCount` is non-optional and
+    // always present, defaulting to 0.
+    lastReadAt: isoDateString.optional(),
+    readCount: z.number().int(),
+    customProperties: z.array(CustomPropertyValueDTO),
+});
+/// Mirror of `PropertyOptionDTO` in RubienCLI.swift. `value` is the canonical
+/// identity (option string for custom selects; stringified tag id for the
+/// built-in Tags property). `label` is the display text — equal to `value`
+/// for custom options, and the Tag's name for Tags-routed options.
+export const PropertyOptionDTO = z.object({
+    value: z.string(),
+    label: z.string(),
+    color: z.string(),
+});
+export const PropertyDefinitionDTO = z.object({
+    id: z.string(),
+    name: z.string(),
+    type: z.string(),
+    options: z.array(PropertyOptionDTO),
+    sortOrder: z.number().int(),
+    isDefault: z.boolean(),
+    defaultFieldKey: z.string().optional(),
+    isVisible: z.boolean(),
+});
+// PDF-download status DTO emitted by `add --identifier --download-pdf` and by
+// `pdf download <id>`. Mirrors PDFDownloadStatusDTO in RubienCLI.swift.
+// `action` is the raw value of PDFDownloadAction (downloaded | already-attached
+// | already-pending | skipped). All fields except `ok` use plain `Optional` in
+// Swift → key omitted when nil → `.optional()` here.
+export const PDFDownloadStatusDTO = z.object({
+    ok: z.boolean(),
+    action: z.string().optional(),
+    filename: z.string().optional(),
+    error: z.string().optional(),
+});
+// Envelope returned by `add` (single object) or `add --bibtex` (array of these).
+// `status` mirrors AppDatabase.ReferenceSaveResult.
+// `pdfDownload` is an AlwaysEncodedOptional in Swift, so it's always present
+// in the JSON — explicit `null` when --download-pdf wasn't set.
+export const AddStatusOutput = z.object({
+    reference: ReferenceDTO,
+    status: z.enum(["created", "existing"]),
+    pdfDownload: PDFDownloadStatusDTO.nullable(),
+});
+// TagDTO retired alongside the rubien_tags_* MCP tool family. Tag rows now
+// surface as inline options on the built-in Tags PropertyDefinition (see
+// PropertyOptionDTO above): `value` is the stringified tag id, `label` is
+// the tag name, `color` is the tag color.
+// Citation outputs (three formats: text, bibliography, docx-cc).
+export const CitationTextOutput = z.object({
+    style: z.string(),
+    inline: z.string(),
+    bibliography: z.array(z.string()),
+});
+export const CitationBibliographyOutput = z.object({
+    style: z.string(),
+    entries: z.array(z.string()),
+});
+export const CitationDocxCCOutput = z.object({
+    tag: z.string(),
+    text: z.string(),
+    style: z.string(),
+    isShortTag: z.boolean().optional(),
+    fallbackPayload: z.string().optional(),
+});
+// View DTO: groupBy uses AlwaysEncodedOptional → nullable in JSON.
+export const ViewFilter = z.object({}).passthrough(); // structural detail varies; accept any shape
+export const ViewSort = z.object({}).passthrough();
+export const ColumnConfig = z.object({}).passthrough();
+export const GroupConfig = z.object({}).passthrough();
+export const ViewScope = z.object({}).passthrough();
+export const DatabaseViewDTO = z.object({
+    id: z.number().int().optional(),
+    name: z.string(),
+    icon: z.string(),
+    isDefault: z.boolean(),
+    displayOrder: z.number().int(),
+    scope: ViewScope,
+    columns: z.array(ColumnConfig),
+    filters: z.array(ViewFilter),
+    sorts: z.array(ViewSort),
+    groupBy: GroupConfig.nullable(), // AlwaysEncodedOptional → explicit null
+    dateCreated: isoDateString,
+    dateModified: isoDateString,
+});
+export const AnnotationDTO = z.object({
+    id: z.number().int(),
+    type: z.string(),
+    color: z.string().optional(),
+    pageIndex: z.number().int().optional(),
+    selectedText: z.string().optional(),
+    noteText: z.string().optional(),
+});
+export const StyleDTO = z.object({
+    id: z.string(),
+    title: z.string(),
+    isBuiltin: z.boolean(),
+    citationKind: z.string(),
+});
+export const SyncStatusDTO = z
+    .object({
+    enabled: z.boolean(),
+    containerIdentifier: z.string().optional(),
+    entitlementPresent: z.boolean(),
+    iCloudAccountAvailable: z.boolean(),
+    appLockHeld: z.boolean().optional(),
+    baselineState: z.string(),
+    dirtyByEntityType: z.record(z.number()).optional(),
+    tombstoneCount: z.number().optional(),
+    syncEngineState: z.unknown().optional(),
+    schemaVersion: z.number().int().optional(),
+})
+    .passthrough(); // sync status is relatively fluid; keep forward-compat
+export const DeleteResultDTO = z.object({ deleted: z.string() });
+export const ImportResultDTO = z
+    .object({ imported: z.number().int(), file: z.string() })
+    .passthrough();
+export const CliErrorDTO = z.object({ error: z.string() });
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/server.js

@@ -0,0 +1,33 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerReferenceTools } from "./tools/references.js";
+import { registerCitationTools } from "./tools/citations.js";
+import { registerIOTools } from "./tools/io.js";
+import { registerPropertyTools } from "./tools/properties.js";
+import { registerViewTools } from "./tools/views.js";
+import { registerAnnotationTools } from "./tools/annotations.js";
+import { registerSyncTools } from "./tools/sync.js";
+import { registerPdfTools } from "./tools/pdf.js";
+import { registerWebTools } from "./tools/web.js";
+export const SERVER_INFO = {
+    name: "rubien-mcp-server",
+    version: "0.1.0",
+};
+export function buildServer() {
+    const server = new McpServer(SERVER_INFO, {
+        capabilities: { tools: {} },
+    });
+    registerReferenceTools(server);
+    registerCitationTools(server);
+    registerIOTools(server);
+    // Tags are exposed through the `properties` family against the built-in
+    // Tags PropertyDefinition (defaultFieldKey == "tags"). The standalone
+    // rubien_tags_* tool family was retired — see properties.ts.
+    registerPropertyTools(server);
+    registerViewTools(server);
+    registerAnnotationTools(server);
+    registerPdfTools(server);
+    registerWebTools(server);
+    registerSyncTools(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;CACR,CAAC;AAEX,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE;QACxC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;KAC5B,CAAC,CAAC;IAEH,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,wEAAwE;IACxE,sEAAsE;IACtE,6DAA6D;IAC7D,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/toolHelpers.js

@@ -0,0 +1,48 @@
+import { CliError, invokeCli } from "./cli.js";
+/**
+ * Invoke rubien-cli and wrap the result as a CallToolResult. Errors from the
+ * CLI are mapped to `isError: true` with the stderr message. Any other error
+ * (missing binary, timeout) propagates as an exception which the MCP SDK
+ * converts into a protocol-level error.
+ *
+ * We only return text content (pretty-printed JSON). MCP's `structuredContent`
+ * expects an object-shape, but many CLI responses are arrays — returning them
+ * as plain text keeps the Claude-facing contract simple and lossless.
+ */
+export async function runCliAsTool(args, options = {}) {
+    try {
+        const result = await invokeCli(args, options);
+        const asText = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+        return {
+            content: [{ type: "text", text: asText }],
+        };
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            return {
+                content: [{ type: "text", text: err.message }],
+                isError: true,
+            };
+        }
+        throw err;
+    }
+}
+/**
+ * Filter undefined values out of an optional-argument map and render them as
+ * `--flag value` / `--flag` pairs. Undefined/null skip the flag entirely.
+ */
+export function flagsFromOptions(opts) {
+    const out = [];
+    for (const [key, value] of Object.entries(opts)) {
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === "boolean") {
+            if (value)
+                out.push(key);
+            continue;
+        }
+        out.push(key, String(value));
+    }
+    return out;
+}
+//# sourceMappingURL=toolHelpers.js.map

package/dist/toolHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHelpers.js","sourceRoot":"","sources":["../src/toolHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc,EAAE,UAAsB,EAAE;IACzE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACnD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAkE;IAElE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,KAAK;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tools/annotations.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import { runCliAsTool } from "../toolHelpers.js";
+export function registerAnnotationTools(server) {
+    server.registerTool("rubien_annotations_list", {
+        title: "List PDF annotations for a reference",
+        description: "Return all PDF annotations (highlights, underlines, anchored notes) on a single reference's attached PDF. PDF references only — for clipped web pages, use `rubien_web_annotations` instead. Returns [{ id, type, color, pageIndex, selectedText, noteText }].",
+        inputSchema: {
+            referenceId: z.number().int(),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ referenceId }) => runCliAsTool(["annotations", String(referenceId)]));
+}
+//# sourceMappingURL=annotations.js.map

package/dist/tools/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/tools/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,sCAAsC;QAC7C,WAAW,EACT,gQAAgQ;QAClQ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;SAC9B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CACxB,YAAY,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CACrD,CAAC;AACJ,CAAC"}

package/dist/tools/citations.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { runCliAsTool } from "../toolHelpers.js";
+const BUILTIN_STYLES = [
+    "apa",
+    "mla",
+    "chicago",
+    "ieee",
+    "harvard",
+    "vancouver",
+    "nature",
+];
+const CITE_FORMATS = ["text", "bibliography", "docx-cc"];
+export function registerCitationTools(server) {
+    server.registerTool("rubien_cite", {
+        title: "Format citations",
+        description: "Generate formatted citations for one or more references. Output shape varies by format: `text` → { style, inline, bibliography }, `bibliography` → { style, entries }, `docx-cc` → { tag, text, style, isShortTag?, fallbackPayload? }. Use arbitrary CSL style IDs from `rubien_styles_list` if needed.",
+        inputSchema: {
+            ids: z.array(z.number().int()).min(1).describe("Reference IDs to cite"),
+            style: z
+                .string()
+                .optional()
+                .describe(`Citation style (default apa). Built-ins: ${BUILTIN_STYLES.join(", ")}. Any CSL ID from rubien_styles_list also works.`),
+            format: z
+                .enum(CITE_FORMATS)
+                .optional()
+                .describe("Output format (default text). 'bibliography' for reference-list entries only; 'docx-cc' for Word content-control tags."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ ids, style, format }) => {
+        const args = ["cite", ...ids.map((n) => String(n))];
+        if (style)
+            args.push("--style", style);
+        if (format)
+            args.push("--format", format);
+        return runCliAsTool(args);
+    });
+    server.registerTool("rubien_styles_list", {
+        title: "List citation styles",
+        description: "List all available citation styles (built-in + installed CSL). Use the returned `id` as the `style` argument to rubien_cite.",
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => runCliAsTool(["styles"]));
+}
+//# sourceMappingURL=citations.js.map

package/dist/tools/citations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.js","sourceRoot":"","sources":["../../src/tools/citations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,cAAc,GAAG;IACrB,KAAK;IACL,KAAK;IACL,SAAS;IACT,MAAM;IACN,SAAS;IACT,WAAW;IACX,QAAQ;CACA,CAAC;AAEX,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAU,CAAC;AAElE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,0SAA0S;QAC5S,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACvE,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,4CAA4C,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,kDAAkD,CACxH;YACH,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,YAAY,CAAC;iBAClB,QAAQ,EAAE;iBACV,QAAQ,CACP,wHAAwH,CACzH;SACJ;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAa,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CACrC,CAAC;AACJ,CAAC"}

package/dist/tools/io.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { flagsFromOptions, runCliAsTool } from "../toolHelpers.js";
+export function registerIOTools(server) {
+    server.registerTool("rubien_import", {
+        title: "Import from BibTeX/RIS/Zotero folder",
+        description: "Import references from a file (BibTeX .bib / RIS .ris) or a Zotero-exported folder. For folder imports you can stamp a single-/multi-select property value on every imported reference via property + value.",
+        inputSchema: {
+            file: z
+                .string()
+                .describe("Absolute path on the host. Stdin piping ('-') is not supported through the MCP wrapper; if you need it, invoke rubien-cli directly."),
+            format: z
+                .enum(["bib", "ris"])
+                .optional()
+                .describe("Override the format inferred from the file extension."),
+            property: z
+                .string()
+                .optional()
+                .describe("(Zotero folder only) Property name to stamp on imported refs"),
+            value: z
+                .string()
+                .optional()
+                .describe("(Zotero folder only) Value for --property on imported refs"),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ file, format, property, value }) => runCliAsTool([
+        "import",
+        file,
+        ...flagsFromOptions({
+            "--format": format,
+            "--property": property,
+            "--value": value,
+        }),
+    ], { timeoutMs: 180_000 }));
+    server.registerTool("rubien_export", {
+        title: "Export references",
+        description: "Export the library (or a subset) as JSON, BibTeX, or RIS. BibTeX/RIS output is plain text; JSON is a ReferenceDTO[] array.",
+        inputSchema: {
+            format: z.enum(["json", "bibtex", "ris"]).optional()
+                .describe("Default is json"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ format }) => {
+        const args = ["export"];
+        if (format)
+            args.push("--format", format);
+        const textMode = format === "bibtex" || format === "ris";
+        return runCliAsTool(args, { textMode });
+    });
+}
+//# sourceMappingURL=io.js.map

package/dist/tools/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/tools/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,sCAAsC;QAC7C,WAAW,EACT,8MAA8M;QAChN,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,qIAAqI,CACtI;YACH,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;iBACpB,QAAQ,EAAE;iBACV,QAAQ,CAAC,uDAAuD,CAAC;YACpE,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,8DAA8D,CAAC;YAC3E,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;SAC1E;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAC1C,YAAY,CACV;QACE,QAAQ;QACR,IAAI;QACJ,GAAG,gBAAgB,CAAC;YAClB,UAAU,EAAE,MAAM;YAClB,YAAY,EAAE,QAAQ;YACtB,SAAS,EAAE,KAAK;SACjB,CAAC;KACH,EACD,EAAE,SAAS,EAAE,OAAO,EAAE,CACvB,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,4HAA4H;QAC9H,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACjD,QAAQ,CAAC,iBAAiB,CAAC;SAC/B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,IAAI,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,KAAK,CAAC;QACzD,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC,CACF,CAAC;AACJ,CAAC"}