README.md

metadata

title: Hidden Gems - Undervalued HF Models
sdk: docker
app_port: 7860

🔍 Hidden Gems Finder

An MCP Server that discovers undervalued Hugging Face models with high likes-to-downloads ratios — quality models that haven't gone viral yet!

What are Hidden Gems?

The Hidden Gem Score = Likes / Downloads

• High ratio = Loved by the community, but not widely adopted (undervalued!)
• Low ratio = Popular but mainstream (already discovered)

This helps you find quality models before they blow up.

MCP Tools

find_hidden_gems

Search for undervalued models with various filters:

Parameters:

• limit (int): Models to fetch from API (default: 100)
• min_downloads (int): Filter out brand-new models (default: 100)
• top (int): Number of results to return (default: 20)
• pipeline_tag (str, optional): Filter by type like "text-generation", "image-to-text"
• sort_by (str): Sort by "ratio" (default), "likes", "downloads", or "trending"

Example: Find text generation gems

{
  "limit": 200,
  "min_downloads": 100,
  "top": 10,
  "pipeline_tag": "text-generation",
  "sort_by": "ratio"
}

get_model_details

Get detailed information about a specific model:

Parameters:

• model_id (str): The model ID (e.g., "microsoft/DialoGPT-medium")

Example:

{"model_id": "openbmb/MiniCPM-SALA"}

Usage Examples

Find Top 20 Hidden Gems

find_hidden_gems()

Find Text Generation Gems

find_hidden_gems(pipeline_tag="text-generation", top=15)

Deep Search

find_hidden_gems(limit=500, min_downloads=500, top=50, sort_by="likes")

Check Specific Model

get_model_details("xai-org/grok-1")

Connecting to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hidden-gems": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://evalstate-hidden-gems.hf.space/mcp"]
    }
  }
}

Environment Variables

• HF_TOKEN: Optional Hugging Face token for higher API rate limits