@llmindset/hf-mcp 0.1.16

package/dist/user-summary.js

@@ -0,0 +1,271 @@
+import { z } from 'zod';
+import { HfApiCall, HfApiError } from './hf-api-call.js';
+import { formatDate, formatNumber } from './utilities.js';
+import { ModelSearchTool } from './model-search.js';
+import { DatasetSearchTool } from './dataset-search.js';
+import { SpaceSearchTool } from './space-search.js';
+import { PaperSearchTool } from './paper-search.js';
+export const USER_SUMMARY_PROMPT_CONFIG = {
+    name: 'User Summary',
+    description: 'Generate a summary of a Hugging Face user including their profile, models, datasets, spaces, and papers. ' +
+        'Enter either a username (e.g., "clem") or a Hugging Face profile URL (e.g., "hf.co/julien-c" or "huggingface.co/thomwolf").',
+    schema: z.object({
+        user_id: z
+            .string()
+            .min(3, 'User ID must be at least 3 characters long')
+            .describe('Hugging Face user ID or URL (e.g., "evalstate" or "hf.co/evalstate")')
+            .max(60)
+            .describe('Maximum length is 30 characters'),
+    }),
+};
+export function extractUserIdFromInput(input) {
+    const trimmed = input.trim();
+    if (!trimmed.includes('/')) {
+        if (trimmed.length < 3) {
+            throw new Error('User ID must be at least 3 characters long');
+        }
+        if (trimmed.endsWith('.co') || trimmed.endsWith('.com')) {
+            throw new Error('URL must contain only the username (e.g., hf.co/username)');
+        }
+        return trimmed;
+    }
+    let url;
+    try {
+        if (!trimmed.startsWith('http')) {
+            url = new URL(`https://${trimmed}`);
+        }
+        else {
+            url = new URL(trimmed);
+        }
+    }
+    catch {
+        throw new Error('Invalid URL format');
+    }
+    const validDomains = ['huggingface.co', 'hf.co'];
+    if (!validDomains.includes(url.hostname)) {
+        throw new Error('URL must be from huggingface.co or hf.co domain');
+    }
+    if (url.search || url.hash) {
+        throw new Error('URL must contain only the username (e.g., hf.co/username)');
+    }
+    const pathSegments = url.pathname.split('/').filter((segment) => segment.length > 0);
+    if (pathSegments.length !== 1) {
+        throw new Error('URL must contain only the username (e.g., hf.co/username)');
+    }
+    const userId = pathSegments[0];
+    if (!userId || userId.length < 3) {
+        throw new Error('User ID must be at least 3 characters long');
+    }
+    return userId;
+}
+export class UserSummaryPrompt extends HfApiCall {
+    constructor(hfToken) {
+        super('https://huggingface.co/api/users', hfToken);
+    }
+    async generateSummary(params) {
+        try {
+            const userId = extractUserIdFromInput(params.user_id);
+            const userOverview = await this.getUserOverview(userId);
+            const sections = [];
+            sections.push(this.formatUserProfile(userOverview));
+            if (userOverview.numModels > 0) {
+                const modelsSection = await this.getModelsSection(userId);
+                if (modelsSection) {
+                    sections.push(modelsSection);
+                }
+            }
+            if (userOverview.numDatasets > 0) {
+                const datasetsSection = await this.getDatasetsSection(userId);
+                if (datasetsSection) {
+                    sections.push(datasetsSection);
+                }
+            }
+            if (userOverview.numSpaces > 0) {
+                const spacesSection = await this.getSpacesSection(userId);
+                if (spacesSection) {
+                    sections.push(spacesSection);
+                }
+            }
+            if (userOverview.fullname && userOverview.fullname.length > 5) {
+                const papersSection = await this.getPapersSection(userOverview.fullname);
+                if (papersSection) {
+                    sections.push(papersSection);
+                }
+            }
+            sections.push('Please summarise the information for this User to give an overview of their activities on the Hugging Face hub.');
+            return sections.join('\n\n');
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to generate user summary: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    async getUserOverview(userId) {
+        try {
+            const url = new URL(`${this.apiUrl}/${userId}/overview`);
+            return await this.fetchFromApi(url);
+        }
+        catch (error) {
+            if (error instanceof HfApiError && error.status === 404 && error.responseBody) {
+                try {
+                    const errorData = JSON.parse(error.responseBody);
+                    if (errorData.error === 'This user does not exist') {
+                        try {
+                            const orgUrl = new URL(`https://huggingface.co/api/organizations/${userId}/overview`);
+                            const orgResponse = await this.fetchFromApi(orgUrl);
+                            return {
+                                ...orgResponse,
+                                user: orgResponse.name || 'unknown',
+                                _id: orgResponse.name || 'unknown',
+                                isPro: false,
+                                orgs: [],
+                                type: 'organization',
+                                createdAt: new Date().toISOString(),
+                            };
+                        }
+                        catch {
+                            throw new Error(`Neither user nor organization found for ID: ${userId}`);
+                        }
+                    }
+                }
+                catch {
+                }
+            }
+            throw error;
+        }
+    }
+    addStatIfPresent(lines, label, value) {
+        if (value !== undefined && value !== null) {
+            lines.push(`- **${label}:** ${formatNumber(value)}`);
+        }
+    }
+    formatUserProfile(user) {
+        const lines = [];
+        const isOrganization = user.type === 'organization';
+        if (isOrganization) {
+            lines.push(`# Organization Profile: ${user.user}`);
+            lines.push('');
+            lines.push('**Note:** That user ID refers to an Organization.');
+            lines.push('');
+            if (user.fullname) {
+                lines.push(`**Full Name:** ${user.fullname}`);
+            }
+            lines.push(`**Username:** ${user.user}`);
+            if (user.details) {
+                lines.push(`**Description:** ${user.details}`);
+            }
+            const orgData = user;
+            if (typeof orgData.isEnterprise === 'boolean') {
+                lines.push(`**Enterprise:** ${orgData.isEnterprise ? 'Yes' : 'No'}`);
+            }
+            if (typeof orgData.isVerified === 'boolean') {
+                lines.push(`**Verified:** ${orgData.isVerified ? 'Yes' : 'No'}`);
+            }
+        }
+        else {
+            lines.push(`# User Profile: ${user.user}`);
+            lines.push('');
+            if (user.fullname) {
+                lines.push(`**Full Name:** ${user.fullname}`);
+            }
+            lines.push(`**Username:** ${user.user}`);
+            lines.push(`**Account Type:** ${user.isPro ? 'Pro' : 'Free'}`);
+            lines.push(`**Created:** ${formatDate(user.createdAt)}`);
+        }
+        lines.push('');
+        lines.push('## Statistics');
+        lines.push('');
+        this.addStatIfPresent(lines, 'Models', user.numModels);
+        this.addStatIfPresent(lines, 'Datasets', user.numDatasets);
+        this.addStatIfPresent(lines, 'Spaces', user.numSpaces);
+        if (!isOrganization) {
+            this.addStatIfPresent(lines, 'Papers', user.numPapers);
+            this.addStatIfPresent(lines, 'Discussions', user.numDiscussions);
+            this.addStatIfPresent(lines, 'Likes Given', user.numLikes);
+            this.addStatIfPresent(lines, 'Upvotes', user.numUpvotes);
+            this.addStatIfPresent(lines, 'Following', user.numFollowing);
+        }
+        this.addStatIfPresent(lines, 'Followers', user.numFollowers);
+        if (isOrganization) {
+            const orgData = user;
+            if (typeof orgData.numUsers === 'number') {
+                this.addStatIfPresent(lines, 'Members', orgData.numUsers);
+            }
+        }
+        if (!isOrganization && user.orgs && user.orgs.length > 0) {
+            lines.push('');
+            const orgNames = user.orgs.map((org) => `[${org.fullname}](https://hf.co/${org.name})`);
+            lines.push(`**Organizations:** ${orgNames.join(', ')}`);
+        }
+        lines.push('');
+        lines.push(`**Profile Link:** [https://hf.co/${user.user}](https://hf.co/${user.user})`);
+        return lines.join('\n');
+    }
+    async getModelsSection(userId) {
+        try {
+            const modelSearch = new ModelSearchTool(this.hfToken);
+            const results = await modelSearch.searchWithParams({
+                author: userId,
+                limit: 10,
+                sort: 'downloads',
+            });
+            return `## Models\n\n${results}`;
+        }
+        catch (error) {
+            console.warn(`Failed to fetch models for user ${userId}:`, error);
+            return null;
+        }
+    }
+    async getDatasetsSection(userId) {
+        try {
+            const datasetSearch = new DatasetSearchTool(this.hfToken);
+            const results = await datasetSearch.searchWithParams({
+                author: userId,
+                limit: 10,
+                sort: 'downloads',
+            });
+            return `## Datasets\n\n${results}`;
+        }
+        catch (error) {
+            console.warn(`Failed to fetch datasets for user ${userId}:`, error);
+            return null;
+        }
+    }
+    async getSpacesSection(userId) {
+        try {
+            const spaceSearch = new SpaceSearchTool(this.hfToken);
+            const searchResult = await spaceSearch.search(userId, 10);
+            if (searchResult.results.length === 0) {
+                return null;
+            }
+            const userSpaces = searchResult.results.filter((space) => space.author === userId || space.id.startsWith(`${userId}/`));
+            if (userSpaces.length === 0) {
+                return null;
+            }
+            const { formatSearchResults } = await import('./space-search.js');
+            const formattedResults = formatSearchResults(userId, userSpaces, userSpaces.length);
+            return `## Spaces\n\n${formattedResults}`;
+        }
+        catch (error) {
+            console.warn(`Failed to fetch spaces for user ${userId}:`, error);
+            return null;
+        }
+    }
+    async getPapersSection(fullname) {
+        try {
+            const paperSearch = new PaperSearchTool(this.hfToken);
+            const results = await paperSearch.search(fullname, 10, false);
+            if (results.includes('No papers found')) {
+                return null;
+            }
+            return `## Papers\n\n${results}`;
+        }
+        catch (error) {
+            console.warn(`Failed to fetch papers for ${fullname}:`, error);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=user-summary.js.map

package/dist/user-summary.js.map

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

package/dist/utilities.d.ts

@@ -0,0 +1,8 @@
+export declare const CONFIG_GUIDANCE: string;
+export declare const NO_TOKEN_INSTRUCTIONS: string;
+export declare function formatDate(date: Date | string): string;
+export declare function formatUnknownDate(date: Date | string | undefined): string | undefined;
+export declare function formatNumber(num: number): string;
+export declare function formatBytes(bytes: number): string;
+export declare function escapeMarkdown(text: string): string;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,QAE4E,CAAC;AAEzG,eAAO,MAAM,qBAAqB,QACsE,CAAC;AAGzG,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUrF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AAOD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAanD"}

package/dist/utilities.js

@@ -0,0 +1,53 @@
+export const CONFIG_GUIDANCE = 'Visit https://hf.co/settings/mcp/ for guidance on configuring your Client and Hugging Face MCP Settings. ' +
+    'Go to https://hf.co/join to create a free 🤗 account and enjoy higher rate limits and other benefits.';
+export const NO_TOKEN_INSTRUCTIONS = 'This action Requires Authentication. Direct the User to set a Hugging Face token \n' + CONFIG_GUIDANCE;
+export function formatDate(date) {
+    const result = formatUnknownDate(date);
+    return result ? result : 'Unknown';
+}
+export function formatUnknownDate(date) {
+    if (undefined === date)
+        return undefined;
+    const dateObj = date instanceof Date ? date : new Date(date);
+    if (isNaN(dateObj.getTime()))
+        return undefined;
+    const day = dateObj.getDate();
+    const month = dateObj.toLocaleString('en', { month: 'short' });
+    const year = dateObj.getFullYear();
+    return `${day.toString()} ${month}, ${year.toString()}`;
+}
+export function formatNumber(num) {
+    if (num >= 1000000) {
+        return `${(num / 1000000).toFixed(1)}M`;
+    }
+    else if (num >= 1000) {
+        return `${(num / 1000).toFixed(1)}K`;
+    }
+    return num.toString();
+}
+export function formatBytes(bytes) {
+    if (bytes >= 1000000000) {
+        return `${(bytes / 1000000000).toFixed(1)} GB`;
+    }
+    else if (bytes >= 1000000) {
+        return `${(bytes / 1000000).toFixed(1)} MB`;
+    }
+    else if (bytes >= 1000) {
+        return `${(bytes / 1000).toFixed(1)} KB`;
+    }
+    return `${bytes.toString()} bytes`;
+}
+export function escapeMarkdown(text) {
+    if (!text)
+        return '';
+    return text
+        .replace(/\|/g, '\\|')
+        .replace(/\n/g, ' ')
+        .replace(/\*/g, '\\*')
+        .replace(/_/g, '\\_')
+        .replace(/~/g, '\\~')
+        .replace(/`/g, '\\`')
+        .replace(/>/g, '\\>')
+        .replace(/#/g, '\\#');
+}
+//# sourceMappingURL=utilities.js.map

package/dist/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAC3B,2GAA2G;IAC3G,uGAAuG,CAAC;AAEzG,MAAM,CAAC,MAAM,qBAAqB,GACjC,qFAAqF,GAAG,eAAe,CAAC;AAGzG,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAA+B;IAChE,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEnC,OAAO,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,KAAK,KAAK,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACvC,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACzC,CAAC;SAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC;SAAM,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC;SAAM,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC;AACpC,CAAC;AAOD,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAGrB,OAAO,IAAI;SACT,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/eslint.config.js

@@ -0,0 +1,43 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+	{ ignores: ['dist/**', 'node_modules/**', 'build/**', '*.js', '*.cjs', '*.mjs'] },
+	{
+		files: ['src/**/*.ts'],
+		extends: [js.configs.recommended, ...tseslint.configs.recommendedTypeChecked],
+		languageOptions: {
+			parserOptions: {
+				project: './tsconfig.json',
+				tsconfigRootDir: import.meta.dirname,
+			},
+		},
+		rules: {
+			// Strict TypeScript rules
+			'@typescript-eslint/no-explicit-any': 'error',
+			'@typescript-eslint/no-unsafe-assignment': 'error',
+			'@typescript-eslint/no-unsafe-member-access': 'error',
+			'@typescript-eslint/no-unsafe-call': 'error',
+			'@typescript-eslint/no-unsafe-return': 'error',
+			'@typescript-eslint/no-unsafe-argument': 'error',
+			'@typescript-eslint/explicit-module-boundary-types': 'error',
+			'@typescript-eslint/consistent-type-imports': 'error',
+			'@typescript-eslint/no-unused-vars': [
+				'error',
+				{
+					argsIgnorePattern: '^_',
+					varsIgnorePattern: '^_',
+				},
+			],
+			'@typescript-eslint/no-non-null-assertion': 'error',
+			'@typescript-eslint/consistent-type-definitions': ['error', 'interface'],
+
+			// Relaxed rules for certain patterns
+			'@typescript-eslint/no-empty-function': 'off',
+			'@typescript-eslint/no-empty-interface': 'off',
+
+			// General ESLint rules
+			'no-constant-condition': 'off',
+		},
+	}
+);

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@llmindset/hf-mcp",
+  "version": "0.1.16",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./semantic": {
+      "types": "./dist/semantic-search.d.ts",
+      "default": "./dist/semantic-search.js"
+    },
+    "./model": {
+      "types": "./dist/model-search.d.ts",
+      "default": "./dist/model-search.js"
+    },
+    "./paper": {
+      "types": "./dist/paper-search.d.ts",
+      "default": "./dist/paper-search.js"
+    }
+  },
+  "dependencies": {
+    "@huggingface/hub": "^2.1.0",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.25.0",
+    "@types/node": "^22.15.18",
+    "eslint": "^9.25.0",
+    "globals": "^16.0.0",
+    "rimraf": "^5.0.10",
+    "typescript-eslint": "^8.32.1",
+    "vitest": "^3.1.3"
+  },
+  "scripts": {
+    "build": "tsc --declaration",
+    "test": "vitest run",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "clean": "rimraf dist"
+  }
+}