@pinepaper.studio/mcp-server 1.2.2 → 1.3.1

package/dist/assets/repositories/iconify.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Iconify Asset Repository Adapter
+ *
+ * Fetches SVG icons from iconify.design
+ * Repository info: 200,000+ icons from various icon sets with different licenses
+ */
+import { AssetRepository, AssetResult, AssetMetadata } from '../types.js';
+/**
+ * Iconify adapter
+ *
+ * Uses the Iconify API to search and download icons from multiple icon sets
+ */
+export declare class IconifyAdapter implements AssetRepository {
+    name: string;
+    private apiUrl;
+    /**
+     * Search for icons on Iconify
+     *
+     * @param query Search term
+     * @param limit Maximum results to return
+     */
+    search(query: string, limit: number): Promise<AssetResult[]>;
+    /**
+     * Download SVG content
+     *
+     * @param assetId Asset ID from search results (format: iconify_collection_icon-name)
+     */
+    download(assetId: string): Promise<string>;
+    /**
+     * Get asset metadata
+     *
+     * @param assetId Asset ID
+     */
+    getMetadata(assetId: string): Promise<AssetMetadata>;
+    /**
+     * Parse license from collection info
+     */
+    private parseLicense;
+}
+/**
+ * Create Iconify adapter instance
+ */
+export declare function createIconifyAdapter(): AssetRepository;
+//# sourceMappingURL=iconify.d.ts.map

package/dist/assets/repositories/iconify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconify.d.ts","sourceRoot":"","sources":["../../../src/assets/repositories/iconify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAsBxF;;;;GAIG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,IAAI,SAAa;IAEjB,OAAO,CAAC,MAAM,CAAgC;IAE9C;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmDlE;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkChD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6C1D;;OAEG;IACH,OAAO,CAAC,YAAY;CA+DrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAEtD"}

package/dist/assets/repositories/iconify.js

@@ -0,0 +1,208 @@
+/**
+ * Iconify Asset Repository Adapter
+ *
+ * Fetches SVG icons from iconify.design
+ * Repository info: 200,000+ icons from various icon sets with different licenses
+ */
+/**
+ * Iconify adapter
+ *
+ * Uses the Iconify API to search and download icons from multiple icon sets
+ */
+export class IconifyAdapter {
+    name = 'iconify';
+    apiUrl = 'https://api.iconify.design';
+    /**
+     * Search for icons on Iconify
+     *
+     * @param query Search term
+     * @param limit Maximum results to return
+     */
+    async search(query, limit) {
+        try {
+            // Iconify search endpoint
+            const searchUrl = `${this.apiUrl}/search?query=${encodeURIComponent(query)}&limit=${limit}`;
+            const response = await fetch(searchUrl, {
+                headers: {
+                    'User-Agent': 'PinePaper-MCP-Server/1.2.2',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Iconify search failed: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            if (!data.icons || !Array.isArray(data.icons)) {
+                return [];
+            }
+            // Convert to AssetResult format
+            const results = [];
+            for (const iconName of data.icons.slice(0, limit)) {
+                // Icon name format: "collection:icon-name"
+                const [collection, name] = iconName.split(':');
+                // Get collection info for license
+                const collectionInfo = data.collections?.[collection];
+                const license = this.parseLicense(collectionInfo);
+                results.push({
+                    id: `iconify_${iconName.replace(':', '_')}`,
+                    repository: 'iconify',
+                    title: name?.replace(/-/g, ' ') || iconName,
+                    description: `${name} icon from ${collectionInfo?.name || collection}`,
+                    previewUrl: `https://api.iconify.design/${iconName}.svg`,
+                    downloadUrl: `https://api.iconify.design/${iconName}.svg`,
+                    license,
+                    tags: [query, collection],
+                });
+            }
+            return results;
+        }
+        catch (error) {
+            console.error('[IconifyAdapter] Search error:', error);
+            return [];
+        }
+    }
+    /**
+     * Download SVG content
+     *
+     * @param assetId Asset ID from search results (format: iconify_collection_icon-name)
+     */
+    async download(assetId) {
+        try {
+            // Convert asset ID back to icon name
+            const iconName = assetId
+                .replace('iconify_', '')
+                .replace('_', ':'); // Replace first underscore with colon
+            // Download SVG from Iconify API
+            const svgUrl = `${this.apiUrl}/${iconName}.svg`;
+            const response = await fetch(svgUrl, {
+                headers: {
+                    'User-Agent': 'PinePaper-MCP-Server/1.2.2',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to download icon: ${response.status}`);
+            }
+            const svg = await response.text();
+            // Validate SVG
+            if (!svg.trim().startsWith('<svg') && !svg.includes('<svg')) {
+                throw new Error('Downloaded content is not valid SVG');
+            }
+            return svg;
+        }
+        catch (error) {
+            console.error('[IconifyAdapter] Download error:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get asset metadata
+     *
+     * @param assetId Asset ID
+     */
+    async getMetadata(assetId) {
+        try {
+            const iconName = assetId.replace('iconify_', '').replace('_', ':');
+            const [collection] = iconName.split(':');
+            // Fetch collection info
+            const collectionUrl = `${this.apiUrl}/collection?prefix=${collection}`;
+            const response = await fetch(collectionUrl, {
+                headers: {
+                    'User-Agent': 'PinePaper-MCP-Server/1.2.2',
+                },
+            });
+            if (response.ok) {
+                const data = await response.json();
+                const license = this.parseLicense(data);
+                return {
+                    id: assetId,
+                    repository: this.name,
+                    title: iconName,
+                    license,
+                    downloadedAt: Date.now(),
+                };
+            }
+        }
+        catch (error) {
+            console.error('[IconifyAdapter] Metadata error:', error);
+        }
+        // Fallback metadata
+        return {
+            id: assetId,
+            repository: this.name,
+            title: assetId.replace('iconify_', ''),
+            license: {
+                type: 'Mixed',
+                name: 'Various Licenses (check collection)',
+                requiresAttribution: true,
+                allowsCommercial: false,
+            },
+            downloadedAt: Date.now(),
+        };
+    }
+    /**
+     * Parse license from collection info
+     */
+    parseLicense(collectionInfo) {
+        if (!collectionInfo?.license) {
+            return {
+                type: 'Mixed',
+                name: 'Various Licenses',
+                requiresAttribution: true,
+                allowsCommercial: false,
+            };
+        }
+        const license = collectionInfo.license;
+        const spdx = license.spdx || license.title || '';
+        // Map common licenses
+        if (spdx.includes('MIT')) {
+            return {
+                type: 'MIT',
+                name: 'MIT License',
+                requiresAttribution: true,
+                allowsCommercial: true,
+                url: license.url || 'https://opensource.org/licenses/MIT',
+            };
+        }
+        if (spdx.includes('Apache')) {
+            return {
+                type: 'Apache-2.0',
+                name: 'Apache License 2.0',
+                requiresAttribution: true,
+                allowsCommercial: true,
+                url: license.url || 'https://www.apache.org/licenses/LICENSE-2.0',
+            };
+        }
+        if (spdx.includes('CC0')) {
+            return {
+                type: 'CC0',
+                name: 'Public Domain (CC0)',
+                requiresAttribution: false,
+                allowsCommercial: true,
+                url: license.url || 'https://creativecommons.org/publicdomain/zero/1.0/',
+            };
+        }
+        if (spdx.includes('CC-BY')) {
+            return {
+                type: 'CC-BY-4.0',
+                name: 'Creative Commons Attribution',
+                requiresAttribution: true,
+                allowsCommercial: true,
+                url: license.url || 'https://creativecommons.org/licenses/by/4.0/',
+            };
+        }
+        // Generic license
+        return {
+            type: spdx || 'Unknown',
+            name: license.title || 'Check Collection License',
+            requiresAttribution: true,
+            allowsCommercial: false,
+            url: license.url,
+        };
+    }
+}
+/**
+ * Create Iconify adapter instance
+ */
+export function createIconifyAdapter() {
+    return new IconifyAdapter();
+}
+//# sourceMappingURL=iconify.js.map

package/dist/assets/repositories/iconify.js.map

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

package/dist/assets/repositories/openclipart.d.ts

@@ -0,0 +1,41 @@
+/**
+ * OpenClipart Asset Repository Adapter
+ *
+ * Fetches SVG assets from openclipart.org
+ * Repository info: 150,000+ public domain clipart (CC0 license)
+ */
+import { AssetRepository, AssetResult, AssetMetadata } from '../types.js';
+/**
+ * OpenClipart adapter
+ *
+ * Uses the OpenClipart API to search and download public domain SVG clipart
+ */
+export declare class OpenClipartAdapter implements AssetRepository {
+    name: string;
+    private baseUrl;
+    private apiUrl;
+    /**
+     * Search for assets on OpenClipart
+     *
+     * @param query Search term
+     * @param limit Maximum results to return
+     */
+    search(query: string, limit: number): Promise<AssetResult[]>;
+    /**
+     * Download SVG content
+     *
+     * @param assetId Asset ID from search results
+     */
+    download(assetId: string): Promise<string>;
+    /**
+     * Get asset metadata
+     *
+     * @param assetId Asset ID
+     */
+    getMetadata(assetId: string): Promise<AssetMetadata>;
+}
+/**
+ * Create OpenClipart adapter instance
+ */
+export declare function createOpenClipartAdapter(): AssetRepository;
+//# sourceMappingURL=openclipart.d.ts.map

package/dist/assets/repositories/openclipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclipart.d.ts","sourceRoot":"","sources":["../../../src/assets/repositories/openclipart.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAwBxF;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,IAAI,SAAiB;IAErB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAyC;IAEvD;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4ClE;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwDhD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAe3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D"}

package/dist/assets/repositories/openclipart.js

@@ -0,0 +1,138 @@
+/**
+ * OpenClipart Asset Repository Adapter
+ *
+ * Fetches SVG assets from openclipart.org
+ * Repository info: 150,000+ public domain clipart (CC0 license)
+ */
+/**
+ * OpenClipart adapter
+ *
+ * Uses the OpenClipart API to search and download public domain SVG clipart
+ */
+export class OpenClipartAdapter {
+    name = 'openclipart';
+    baseUrl = 'https://openclipart.org';
+    apiUrl = 'https://openclipart.org/search/json';
+    /**
+     * Search for assets on OpenClipart
+     *
+     * @param query Search term
+     * @param limit Maximum results to return
+     */
+    async search(query, limit) {
+        try {
+            // OpenClipart API endpoint
+            const searchUrl = `${this.apiUrl}?query=${encodeURIComponent(query)}&amount=${limit}`;
+            const response = await fetch(searchUrl, {
+                headers: {
+                    'User-Agent': 'PinePaper-MCP-Server/1.2.2',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`OpenClipart search failed: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            if (!data.payload || !Array.isArray(data.payload)) {
+                return [];
+            }
+            // Convert to AssetResult format
+            return data.payload.slice(0, limit).map((item) => ({
+                id: `openclipart_${item.id}`,
+                repository: 'openclipart',
+                title: item.title || 'Untitled',
+                description: item.description || `${item.title} from OpenClipart`,
+                previewUrl: item.png_thumb?.url || item.svg?.url || '',
+                downloadUrl: item.svg?.url || '',
+                license: {
+                    type: 'CC0',
+                    name: 'Public Domain (CC0)',
+                    requiresAttribution: false,
+                    allowsCommercial: true,
+                    url: 'https://creativecommons.org/publicdomain/zero/1.0/',
+                },
+                tags: item.tags || [query],
+            }));
+        }
+        catch (error) {
+            console.error('[OpenClipartAdapter] Search error:', error);
+            return [];
+        }
+    }
+    /**
+     * Download SVG content
+     *
+     * @param assetId Asset ID from search results
+     */
+    async download(assetId) {
+        try {
+            // For OpenClipart, the download URL should be stored with the asset
+            // If we need to fetch it, we'd query the API again
+            const clipartId = assetId.replace('openclipart_', '');
+            // Fetch the detail page to get download URL
+            const detailUrl = `${this.baseUrl}/detail/${clipartId}`;
+            const response = await fetch(detailUrl, {
+                headers: {
+                    'User-Agent': 'PinePaper-MCP-Server/1.2.2',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch detail page: ${response.status}`);
+            }
+            const html = await response.text();
+            // Extract SVG download URL from page
+            const svgUrlMatch = html.match(/href="([^"]*\.svg)"/i);
+            if (!svgUrlMatch) {
+                throw new Error('Could not find SVG download URL');
+            }
+            const svgUrl = svgUrlMatch[1].startsWith('http')
+                ? svgUrlMatch[1]
+                : `${this.baseUrl}${svgUrlMatch[1]}`;
+            // Download the SVG
+            const svgResponse = await fetch(svgUrl, {
+                headers: {
+                    'User-Agent': 'PinePaper-MCP-Server/1.2.2',
+                },
+            });
+            if (!svgResponse.ok) {
+                throw new Error(`Failed to download SVG: ${svgResponse.status}`);
+            }
+            const svg = await svgResponse.text();
+            // Validate SVG
+            if (!svg.trim().startsWith('<svg') && !svg.includes('<svg')) {
+                throw new Error('Downloaded content is not valid SVG');
+            }
+            return svg;
+        }
+        catch (error) {
+            console.error('[OpenClipartAdapter] Download error:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get asset metadata
+     *
+     * @param assetId Asset ID
+     */
+    async getMetadata(assetId) {
+        return {
+            id: assetId,
+            repository: this.name,
+            title: assetId.replace('openclipart_', ''),
+            license: {
+                type: 'CC0',
+                name: 'Public Domain (CC0)',
+                requiresAttribution: false,
+                allowsCommercial: true,
+                url: 'https://creativecommons.org/publicdomain/zero/1.0/',
+            },
+            downloadedAt: Date.now(),
+        };
+    }
+}
+/**
+ * Create OpenClipart adapter instance
+ */
+export function createOpenClipartAdapter() {
+    return new OpenClipartAdapter();
+}
+//# sourceMappingURL=openclipart.js.map

package/dist/assets/repositories/openclipart.js.map

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

package/dist/assets/repositories/svgrepo.d.ts

@@ -0,0 +1,61 @@
+/**
+ * SVGRepo Asset Repository Adapter
+ *
+ * Fetches SVG assets from svgrepo.com
+ * Repository info: 500,000+ free SVG icons with various licenses
+ */
+import { AssetRepository, AssetResult, AssetMetadata } from '../types.js';
+/**
+ * SVGRepo adapter - Real implementation
+ *
+ * Searches and downloads SVG assets from svgrepo.com
+ */
+export declare class SVGRepoAdapter implements AssetRepository {
+    name: string;
+    private baseUrl;
+    private searchUrl;
+    /**
+     * Search for assets on SVGRepo
+     *
+     * @param query Search term (e.g., "rocket", "heart")
+     * @param limit Maximum results to return
+     */
+    search(query: string, limit: number): Promise<AssetResult[]>;
+    /**
+     * Download SVG content
+     *
+     * @param assetId Asset ID from search results (format: svgrepo_12345_slug)
+     */
+    download(assetId: string): Promise<string>;
+    /**
+     * Get asset metadata
+     *
+     * @param assetId Asset ID
+     */
+    getMetadata(assetId: string): Promise<AssetMetadata>;
+    /**
+     * Parse search results from HTML
+     */
+    private parseSearchResults;
+    /**
+     * Parse license information from page HTML
+     */
+    private parseLicenseFromPage;
+    /**
+     * Extract download URL from asset page
+     */
+    private extractDownloadUrl;
+    /**
+     * Convert asset URL to asset ID
+     */
+    private urlToAssetId;
+    /**
+     * Convert asset ID back to URL
+     */
+    private assetIdToUrl;
+}
+/**
+ * Create SVGRepo adapter instance
+ */
+export declare function createSVGRepoAdapter(): AssetRepository;
+//# sourceMappingURL=svgrepo.d.ts.map

package/dist/assets/repositories/svgrepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgrepo.d.ts","sourceRoot":"","sources":["../../../src/assets/repositories/svgrepo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAWxF;;;;GAIG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,IAAI,SAAa;IAEjB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAqC;IAEtD;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAwClE;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkDhD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA+C1D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6C1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAEtD"}