@qianfuv/paper-scanner-mcp 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+type Primitive = boolean | number | string;
+type QueryValue = Primitive | Primitive[] | null | undefined;
+type QueryParams = Record<string, QueryValue>;
+type RequestOptions = {
+    auth?: boolean;
+    body?: unknown;
+    db?: string;
+    query?: QueryParams;
+};
+declare class PaperScannerClient {
+    private readonly apiToken;
+    private readonly baseUrl;
+    private readonly defaultDb;
+    constructor();
+    getDefaultDb(): string | null;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, options?: RequestOptions): Promise<T>;
+    private appendQueryParams;
+    private buildUrl;
+    private normalizeBaseUrl;
+    private readOptionalEnv;
+    private request;
+}
+declare function buildToolResponse(payload: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+declare function toArray<T>(value: T | T[] | undefined): T[] | undefined;
+export { PaperScannerClient, buildToolResponse, toArray };

package/dist/client.js

@@ -0,0 +1,102 @@
+class PaperScannerClient {
+    apiToken;
+    baseUrl;
+    defaultDb;
+    constructor() {
+        this.baseUrl = this.normalizeBaseUrl(process.env.PAPER_SCANNER_API_URL ?? "http://localhost:8000");
+        this.apiToken = this.readOptionalEnv("PAPER_SCANNER_API_TOKEN");
+        this.defaultDb = this.readOptionalEnv("PAPER_SCANNER_DB");
+    }
+    getDefaultDb() {
+        return this.defaultDb;
+    }
+    async delete(path, options = {}) {
+        return this.request("DELETE", path, options);
+    }
+    async get(path, options = {}) {
+        return this.request("GET", path, options);
+    }
+    async post(path, options = {}) {
+        return this.request("POST", path, options);
+    }
+    appendQueryParams(searchParams, query) {
+        if (!query) {
+            return;
+        }
+        for (const [key, value] of Object.entries(query)) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    searchParams.append(key, String(item));
+                }
+                continue;
+            }
+            searchParams.set(key, String(value));
+        }
+    }
+    buildUrl(path, options) {
+        const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+        const url = new URL(`/api${normalizedPath}`, this.baseUrl);
+        const db = options.db ?? this.defaultDb;
+        if (db) {
+            url.searchParams.set("db", db);
+        }
+        this.appendQueryParams(url.searchParams, options.query);
+        return url;
+    }
+    normalizeBaseUrl(value) {
+        return value.endsWith("/") ? value.slice(0, -1) : value;
+    }
+    readOptionalEnv(name) {
+        const value = process.env[name]?.trim();
+        return value ? value : null;
+    }
+    async request(method, path, options) {
+        if (options.auth && !this.apiToken) {
+            throw new Error("PAPER_SCANNER_API_TOKEN is required for authenticated tools");
+        }
+        const headers = new Headers();
+        if (options.auth && this.apiToken) {
+            headers.set("Authorization", `Bearer ${this.apiToken}`);
+        }
+        const init = {
+            method,
+            headers,
+        };
+        if (options.body !== undefined) {
+            headers.set("Content-Type", "application/json");
+            init.body = JSON.stringify(options.body);
+        }
+        const response = await fetch(this.buildUrl(path, options), init);
+        const text = await response.text();
+        if (!response.ok) {
+            const suffix = text ? `: ${text}` : "";
+            throw new Error(`Paper Scanner API request failed with ${response.status} ${response.statusText}${suffix}`);
+        }
+        if (!text) {
+            return undefined;
+        }
+        return JSON.parse(text);
+    }
+}
+function buildToolResponse(payload) {
+    const text = typeof payload === "string" ? payload : JSON.stringify(payload, null, 2);
+    return {
+        content: [
+            {
+                type: "text",
+                text,
+            },
+        ],
+    };
+}
+function toArray(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return Array.isArray(value) ? value : [value];
+}
+export { PaperScannerClient, buildToolResponse, toArray };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { PaperScannerClient } from "./client.js";
+import { registerArticleTools } from "./tools/articles.js";
+import { registerFavoriteTools } from "./tools/favorites.js";
+import { registerJournalTools } from "./tools/journals.js";
+import { registerMetaTools } from "./tools/meta.js";
+import { registerWeeklyTools } from "./tools/weekly.js";
+async function main() {
+    const server = new McpServer({
+        name: "paper-scanner-mcp",
+        version: "1.0.0",
+    });
+    const client = new PaperScannerClient();
+    registerArticleTools(server, client);
+    registerJournalTools(server, client);
+    registerMetaTools(server, client);
+    registerWeeklyTools(server, client);
+    registerFavoriteTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    console.error(message);
+    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":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAExC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/articles.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PaperScannerClient } from "../client.js";
+declare function registerArticleTools(server: McpServer, client: PaperScannerClient): void;
+export { registerArticleTools };

package/dist/tools/articles.js

@@ -0,0 +1,51 @@
+import * as z from "zod/v4";
+import { buildToolResponse, toArray } from "../client.js";
+const articleIdSchema = z.number().int().positive();
+const dateSchema = z.string().trim().min(1);
+const databaseSchema = z.string().trim().min(1);
+const articleListSchema = z.object({
+    area: z.union([z.string().trim().min(1), z.array(z.string().trim().min(1)).min(1)]).optional(),
+    date_from: dateSchema.optional(),
+    date_to: dateSchema.optional(),
+    db: databaseSchema.optional(),
+    journal_id: z.union([articleIdSchema, z.array(articleIdSchema).min(1)]).optional(),
+    limit: z.number().int().min(1).max(200).optional(),
+    open_access: z.boolean().optional(),
+    q: z.string().trim().min(1).optional(),
+    year: z.number().int().nonnegative().optional(),
+});
+function registerArticleTools(server, client) {
+    server.registerTool("search_articles", {
+        description: "Search articles in the Paper Scanner index.",
+        inputSchema: articleListSchema,
+    }, async (params) => {
+        const result = await client.get("/articles", {
+            db: params.db,
+            query: {
+                area: toArray(params.area),
+                date_from: params.date_from,
+                date_to: params.date_to,
+                journal_id: toArray(params.journal_id),
+                limit: params.limit,
+                open_access: params.open_access,
+                q: params.q,
+                year: params.year,
+            },
+        });
+        return buildToolResponse(result);
+    });
+    server.registerTool("get_article", {
+        description: "Get a single article by ID.",
+        inputSchema: z.object({
+            article_id: articleIdSchema,
+            db: databaseSchema.optional(),
+        }),
+    }, async ({ article_id, db }) => {
+        const result = await client.get(`/articles/${article_id}`, {
+            db,
+        });
+        return buildToolResponse(result);
+    });
+}
+export { registerArticleTools };
+//# sourceMappingURL=articles.js.map

package/dist/tools/articles.js.map

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

package/dist/tools/favorites.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PaperScannerClient } from "../client.js";
+declare function registerFavoriteTools(server: McpServer, client: PaperScannerClient): void;
+export { registerFavoriteTools };

package/dist/tools/favorites.js

@@ -0,0 +1,51 @@
+import * as z from "zod/v4";
+import { buildToolResponse } from "../client.js";
+const articleIdSchema = z.number().int().positive();
+const folderIdSchema = z.number().int().positive();
+const databaseNameSchema = z.string().trim().min(1);
+function registerFavoriteTools(server, client) {
+    server.registerTool("list_folders", {
+        description: "List favorite folders for the authenticated Paper Scanner user.",
+        inputSchema: z.object({}),
+    }, async () => {
+        const result = await client.get("/favorites/folders", {
+            auth: true,
+        });
+        return buildToolResponse(result);
+    });
+    server.registerTool("add_favorite", {
+        description: "Add an article to a favorite folder for the authenticated user.",
+        inputSchema: z.object({
+            article_id: articleIdSchema,
+            db_name: databaseNameSchema.optional(),
+            folder_id: folderIdSchema,
+        }),
+    }, async ({ article_id, db_name, folder_id }) => {
+        const result = await client.post(`/favorites/folders/${folder_id}/articles`, {
+            auth: true,
+            body: {
+                article_id,
+                db_name: db_name ?? client.getDefaultDb() ?? "",
+            },
+        });
+        return buildToolResponse(result);
+    });
+    server.registerTool("remove_favorite", {
+        description: "Remove an article from a favorite folder for the authenticated user.",
+        inputSchema: z.object({
+            article_id: articleIdSchema,
+            db_name: databaseNameSchema.optional(),
+            folder_id: folderIdSchema,
+        }),
+    }, async ({ article_id, db_name, folder_id }) => {
+        const result = await client.delete(`/favorites/folders/${folder_id}/articles/${article_id}`, {
+            auth: true,
+            query: {
+                db_name: db_name ?? client.getDefaultDb() ?? "",
+            },
+        });
+        return buildToolResponse(result);
+    });
+}
+export { registerFavoriteTools };
+//# sourceMappingURL=favorites.js.map

package/dist/tools/favorites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favorites.js","sourceRoot":"","sources":["../../src/tools/favorites.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAsB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AACpD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AACnD,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEpD,SAAS,qBAAqB,CAC5B,MAAiB,EACjB,MAA0B;IAE1B,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KAC1B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE;YACpD,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE;YACtC,SAAS,EAAE,cAAc;SAC1B,CAAC;KACH,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,SAAS,WAAW,EAAE;YAC3E,IAAI,EAAE,IAAI;YACV,IAAI,EAAE;gBACJ,UAAU;gBACV,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE;aAChD;SACF,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE;YACtC,SAAS,EAAE,cAAc;SAC1B,CAAC;KACH,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,sBAAsB,SAAS,aAAa,UAAU,EAAE,EACxD;YACE,IAAI,EAAE,IAAI;YACV,KAAK,EAAE;gBACL,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE;aAChD;SACF,CACF,CAAC;QAEF,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/tools/journals.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PaperScannerClient } from "../client.js";
+declare function registerJournalTools(server: McpServer, client: PaperScannerClient): void;
+export { registerJournalTools };

package/dist/tools/journals.js

@@ -0,0 +1,24 @@
+import * as z from "zod/v4";
+import { buildToolResponse } from "../client.js";
+const databaseSchema = z.string().trim().min(1);
+function registerJournalTools(server, client) {
+    server.registerTool("list_journals", {
+        description: "List journals from the selected Paper Scanner database.",
+        inputSchema: z.object({
+            db: databaseSchema.optional(),
+            limit: z.number().int().min(1).max(200).optional(),
+            offset: z.number().int().min(0).optional(),
+        }),
+    }, async ({ db, limit, offset }) => {
+        const result = await client.get("/journals", {
+            db,
+            query: {
+                limit,
+                offset,
+            },
+        });
+        return buildToolResponse(result);
+    });
+}
+export { registerJournalTools };
+//# sourceMappingURL=journals.js.map

package/dist/tools/journals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journals.js","sourceRoot":"","sources":["../../src/tools/journals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAsB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEhD,SAAS,oBAAoB,CAC3B,MAAiB,EACjB,MAA0B;IAE1B,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,EAAE,EAAE,cAAc,CAAC,QAAQ,EAAE;YAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC3C,CAAC;KACH,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE;YAC3C,EAAE;YACF,KAAK,EAAE;gBACL,KAAK;gBACL,MAAM;aACP;SACF,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/tools/meta.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PaperScannerClient } from "../client.js";
+declare function registerMetaTools(server: McpServer, client: PaperScannerClient): void;
+export { registerMetaTools };

package/dist/tools/meta.js

@@ -0,0 +1,34 @@
+import * as z from "zod/v4";
+import { buildToolResponse } from "../client.js";
+const databaseInputSchema = z.object({
+    db: z.string().trim().min(1).optional(),
+});
+function registerMetaTools(server, client) {
+    server.registerTool("list_databases", {
+        description: "List available Paper Scanner SQLite databases.",
+        inputSchema: z.object({}),
+    }, async () => {
+        const result = await client.get("/meta/databases");
+        return buildToolResponse(result);
+    });
+    server.registerTool("list_areas", {
+        description: "List research areas for the selected Paper Scanner database.",
+        inputSchema: databaseInputSchema,
+    }, async ({ db }) => {
+        const result = await client.get("/meta/areas", {
+            db,
+        });
+        return buildToolResponse(result);
+    });
+    server.registerTool("list_years", {
+        description: "List publication years for the selected Paper Scanner database.",
+        inputSchema: databaseInputSchema,
+    }, async ({ db }) => {
+        const result = await client.get("/years", {
+            db,
+        });
+        return buildToolResponse(result);
+    });
+}
+export { registerMetaTools };
+//# sourceMappingURL=meta.js.map

package/dist/tools/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/tools/meta.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAsB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,SAAS,iBAAiB,CACxB,MAAiB,EACjB,MAA0B;IAE1B,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KAC1B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACnD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,mBAAmB;KACjC,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE;YAC7C,EAAE;SACH,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,mBAAmB;KACjC,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE;YACxC,EAAE;SACH,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/tools/weekly.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PaperScannerClient } from "../client.js";
+declare function registerWeeklyTools(server: McpServer, client: PaperScannerClient): void;
+export { registerWeeklyTools };

package/dist/tools/weekly.js

@@ -0,0 +1,19 @@
+import * as z from "zod/v4";
+import { buildToolResponse } from "../client.js";
+function registerWeeklyTools(server, client) {
+    server.registerTool("get_weekly_updates", {
+        description: "Get weekly update summaries across all Paper Scanner databases.",
+        inputSchema: z.object({
+            window_days: z.number().int().min(1).max(31).optional(),
+        }),
+    }, async ({ window_days }) => {
+        const result = await client.get("/weekly-updates", {
+            query: {
+                window_days,
+            },
+        });
+        return buildToolResponse(result);
+    });
+}
+export { registerWeeklyTools };
+//# sourceMappingURL=weekly.js.map

package/dist/tools/weekly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekly.js","sourceRoot":"","sources":["../../src/tools/weekly.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAsB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,SAAS,mBAAmB,CAC1B,MAAiB,EACjB,MAA0B;IAE1B,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SACxD,CAAC;KACH,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACjD,KAAK,EAAE;gBACL,WAAW;aACZ;SACF,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@qianfuv/paper-scanner-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Paper Scanner",
+  "type": "module",
+  "bin": {
+    "paper-scanner-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "typescript": "^5.9.2"
+  }
+}