@withpica/mcp-server 2.1.0

package/dist/tools/uploads.js

@@ -0,0 +1,159 @@
+/**
+ * Upload Tools - MCP tools for uploading any file type (images, videos, documents)
+ * Uses the generic storage presigned upload route that supports all PICA storage providers.
+ */
+import { formatSuccess } from "../utils/formatting.js";
+export class UploadTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_upload_file",
+                    description: "Generate a signed URL for uploading ANY file type — images, videos, documents, or audio. " +
+                        "The storage category is auto-detected from the MIME type. After uploading the file via HTTP PUT " +
+                        "to the returned URL, call pica_upload_complete to finalize. " +
+                        "Supported: images (JPEG, PNG, GIF, WebP, HEIC, AVIF, TIFF), " +
+                        "videos (MP4, QuickTime, WebM, MKV), " +
+                        "documents (PDF, Word, Excel), " +
+                        "audio (WAV, MP3, FLAC, AIFF, OGG, WebM). " +
+                        "For audio files that need BPM/key analysis, use pica_audio_presigned_upload instead.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            filename: {
+                                type: "string",
+                                description: "Original filename with extension (e.g. 'promo-photo.jpg', 'contract.pdf')",
+                            },
+                            content_type: {
+                                type: "string",
+                                description: "MIME type of the file (e.g. 'image/jpeg', 'video/mp4', 'application/pdf')",
+                            },
+                            file_size: {
+                                type: "number",
+                                description: "File size in bytes",
+                            },
+                        },
+                        required: ["filename", "content_type", "file_size"],
+                    },
+                },
+                executor: this.presignedUpload.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_upload_complete",
+                    description: "Finalize a file upload after the file has been PUT to the signed URL from pica_upload_file. " +
+                        "Creates the appropriate database record (multimedia item for images/video, document for PDFs, " +
+                        "audio file for audio). Use the uploadId, key, bucket, and storageCategory from pica_upload_file.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            upload_id: {
+                                type: "string",
+                                description: "The uploadId returned from pica_upload_file",
+                            },
+                            key: {
+                                type: "string",
+                                description: "The storage key returned from pica_upload_file",
+                            },
+                            bucket: {
+                                type: "string",
+                                description: "The bucket returned from pica_upload_file",
+                            },
+                            storage_category: {
+                                type: "string",
+                                description: "The storageCategory returned from pica_upload_file",
+                                enum: ["audio", "media", "documents"],
+                            },
+                            filename: {
+                                type: "string",
+                                description: "Original filename",
+                            },
+                            content_type: {
+                                type: "string",
+                                description: "MIME type of the uploaded file",
+                            },
+                            file_size: {
+                                type: "number",
+                                description: "File size in bytes",
+                            },
+                            title: {
+                                type: "string",
+                                description: "Optional title. Defaults to filename without extension.",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Optional work ID to link the file to (audio only). For images/videos, use pica_multimedia_link_work after upload.",
+                            },
+                            classification: {
+                                type: "string",
+                                description: "For media: classification type (e.g. 'press_photo', 'album_artwork', 'music_video'). " +
+                                    "For documents: category (e.g. 'agreement', 'statement', 'other').",
+                            },
+                            linked_to_type: {
+                                type: "string",
+                                description: "For documents: entity type to link to (e.g. 'work', 'person', 'agreement')",
+                            },
+                            linked_to_id: {
+                                type: "string",
+                                description: "For documents: entity ID to link to",
+                            },
+                        },
+                        required: [
+                            "upload_id",
+                            "key",
+                            "bucket",
+                            "storage_category",
+                            "filename",
+                            "content_type",
+                            "file_size",
+                        ],
+                    },
+                },
+                executor: this.completeUpload.bind(this),
+            },
+        ];
+    }
+    async presignedUpload(args) {
+        const result = await this.pica.storage.presignedUpload({
+            filename: args.filename,
+            contentType: args.content_type,
+            fileSize: args.file_size,
+        });
+        return formatSuccess(`Upload URL generated for "${args.filename}" (category: ${result.storageCategory}). ` +
+            `PUT the file to the uploadUrl, then call pica_upload_complete with uploadId, key, bucket, ` +
+            `storageCategory, and metadata to finalize.`, {
+            uploadUrl: result.uploadUrl,
+            uploadId: result.uploadId,
+            key: result.key,
+            bucket: result.bucket,
+            storageCategory: result.storageCategory,
+            expiresAt: result.expiresAt,
+            metadata: result.metadata,
+        });
+    }
+    async completeUpload(args) {
+        const result = await this.pica.storage.completeUpload({
+            uploadId: args.upload_id,
+            key: args.key,
+            bucket: args.bucket,
+            metadata: {
+                filename: args.filename,
+                contentType: args.content_type,
+                fileSize: args.file_size,
+                storageCategory: args.storage_category,
+                title: args.title,
+                workId: args.work_id,
+                classification: args.classification,
+                documentCategory: args.classification,
+                linkedToType: args.linked_to_type,
+                linkedToId: args.linked_to_id,
+            },
+        });
+        return formatSuccess(`Upload finalized. Created ${result.recordType} record with ID: ${result.recordId}.`, result);
+    }
+}
+//# sourceMappingURL=uploads.js.map

package/dist/tools/uploads.js.map

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

package/dist/tools/works.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Works Tools - MCP tools for managing musical works
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class WorksTools {
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all works tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    /**
+     * List works (server-side search and pagination)
+     */
+    private listWorks;
+    /**
+     * Get work by ID
+     */
+    private getWork;
+    /**
+     * Create work
+     */
+    private createWork;
+    /**
+     * Update work
+     */
+    private updateWork;
+    /**
+     * Delete work
+     */
+    private deleteWork;
+    /**
+     * Verify work
+     */
+    private verifyWork;
+    /**
+     * Search works (server-side)
+     */
+    private searchWorks;
+    /**
+     * Bulk delete works
+     */
+    private bulkDeleteWorks;
+    /**
+     * Get full work context bundle
+     */
+    private getWorkFull;
+}
+//# sourceMappingURL=works.d.ts.map

package/dist/tools/works.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../src/tools/works.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAStE,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA0YzE;;OAEG;YACW,SAAS;IAqBvB;;OAEG;YACW,OAAO;IAYrB;;OAEG;YACW,UAAU;IA8BxB;;OAEG;YACW,UAAU;IAMxB;;OAEG;YACW,UAAU;IAKxB;;OAEG;YACW,UAAU;IAKxB;;OAEG;YACW,WAAW;IAezB;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,WAAW;CAsB1B"}