HF Trending MCP Server

An MCP server that tracks trending models, datasets, and spaces on Hugging Face.

It provides tools and prompts to fetch trending content, search for specific items, and analyze current trends, making it a valuable tool for developers, researchers, and AI enthusiasts.

Features

• Trending Tools: Retrieve the top trending models, datasets, and spaces with customizable limits.
• Search Functionality: Search trending items by query across models, datasets, or spaces.
• Trend Analysis Prompt: A built-in prompt to analyze and summarize current trends on Hugging Face.

Installation

Setup

1. Clone the Repository:
   git clone https://github.com/kukapay/hf-trending-mcp.git cd hf-trending-mcp
2. Install Dependencies:
   pip install mcp[cli] httpx
3. Client Configuration:
   "mcpServers": { "hf-trending-mcp": { "command": "python", "args": [ "path/to/hf-trending-mcp/main.py" ] } }

Usage

Once the server is running or installed, you can interact with it using an MCP client (e.g., Claude Desktop). Below are some example prompts:

Fetch Trending Content

Input:

"Show me the top 5 trending models on Hugging Face."

Output:

Input:

"What are the top 10 trending datasets right now?"

Output:

Input:

"List the top 3 trending spaces."

Output:

Search Trending Items

Input:

"Search for trending NLP models, limit to 5."

Output:

Input:

"Find trending datasets about computer vision."

Output:

Analyze Trends

Input:

"Analyze the current trends on Hugging Face."

Output:

A detailed response combining results from all trending tools, followed by an analysis (generated by the client’s AI):

API Details

Tools

• get_trending_models(limit: int = 10): Fetches trending models with downloads, likes, and tags.
• get_trending_datasets(limit: int = 10): Fetches trending datasets with downloads, likes, and tags.
• get_trending_spaces(limit: int = 10): Fetches trending spaces with likes, SDK info, and tags.
• search_trending(query: str, type: str = "models", limit: int = 10): Searches trending items by query and type.

Prompt

• analyze_trends(): Guides the analysis of trending items with a structured prompt.

License

This project is licensed under the MIT License. See the LICENSE file for details.