** 注意⚠️**：这是一个非官方MCP服务器，灵感来源于Hugging Face的官方MCP服务器。如果官方功能超过了它，它可能会随时被弃用。关于官方服务器，请参见 hf.co/mcp。

一个MCP（模型上下文协议）服务器，为Hugging Face模型和数据集提供语义搜索功能。该服务器使Claude及其他兼容MCP的客户端能够通过自然语言查询搜索、发现和探索Hugging Face生态系统。

特色

• 语义搜索：AI驱动的相似性搜索（不仅仅是关键词匹配）
• 数据集搜索：基于自然语言描述查找数据集
• 模型搜索：查找带有可选参数计数过滤功能的模型
• 相似性搜索：查找与某模型相似的模型/数据集
• 热门内容：获取当前热门模型和数据集
• 详细元数据：通过HuggingFace API访问全面的技术信息
• 模型/数据集卡片：下载README卡片以获取详细信息

可用工具

数据集工具

• search_datasets：使用自然语言查询搜索数据集

Hugging Face Hub Semantic Search MCP Server

⚠️ Note: This is an unofficial MCP server inspired by Hugging Face’s official MCP server. It may be deprecated at any time if official functionality supersedes it. For the official server, see hf.co/mcp.

An MCP (Model Context Protocol) server that provides semantic search capabilities for Hugging Face models and datasets. This server enables Claude and other MCP-compatible clients to search, discover, and explore the Hugging Face ecosystem using natural language queries.

Features

• Semantic Search: AI-powered similarity search (not just keyword matching)
• Dataset Search: Find datasets based on natural language descriptions
• Model Search: Find models with optional parameter count filtering
• Similarity Search: Find similar models/datasets to a given one
• Trending Content: Get currently trending models and datasets
• Detailed Metadata: Access comprehensive technical information via HuggingFace API
• Model/Dataset Cards: Download README cards for detailed information

Tools Available

Dataset Tools

• search_datasets: Search datasets using natural language queries
• find_similar_datasets: Find datasets similar to a specified one
• get_trending_datasets: Get currently trending datasets
• get_dataset_info: Get detailed metadata for a specific dataset
• download_dataset_card: Download README card for a dataset

Model Tools

• search_models: Search models using natural language queries with parameter filtering
• find_similar_models: Find models similar to a specified one
• get_trending_models: Get currently trending models with parameter filtering
• get_model_info: Get detailed metadata for a specific model
• get_model_safetensors_metadata: Get model architecture details and parameter count from safetensors
• download_model_card: Download README card for a model

Installation

Prerequisites

• UV - Fast Python package installer
• Claude Desktop or another MCP-compatible client

Quick Start

No installation needed! UV will automatically fetch and run the server.

Configuration

Claude Desktop Setup

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "huggingface-hub-search": {
      "command": "uvx",
      "args": [
        "git+https://github.com/davanstrien/hub-semantic-search-mcp.git"
      ],
      "env": {
        "HF_SEARCH_API_URL": "https://davanstrien-huggingface-datasets-search-v2.hf.space"
      }
    }
  }
}

Alternative: Local Development Setup

If you want to contribute or modify the code:

# Clone the repository
git clone https://github.com/davanstrien/hub-semantic-search-mcp.git
cd hub-semantic-search-mcp

# Install dependencies with UV
uv sync