Hugging Face MCP Server

MCP server que proporciona accés a l'Hugging Face Dataset Viewer API. Consulta conjunts de dades, explora informació, busca contingut i analitza estadístiques de la extensa col·lecció de conjunts de dades d'aprenentatge automàtic del Hugging Face Hub.

Funcionalitats

• 12 eines MCP que cobreixen tots els punts finalitzadors de l'API:
  • get_dataset_splits - Informació sobre les particions del conjunt de dades
  • get_dataset_info - Metadades i característiques del conjunt de dades
  • get_dataset_first_rows - Previsualització de les primeres 100 files
  • get_dataset_rows - Accés a dades amb paginació
  • search_dataset - Cerca de text complet dins dels conjunts de dades
  • get_dataset_size - Informació sobre la mida del conjunt de dades
  • get_dataset_statistics - Anàlisi estadística
  • filter_dataset - Filtratge de dades similar a SQL
  • check_dataset_validity - Validació del conjunt de dades
  • get_dataset_parquet - Informació sobre el fitxer Parquet
  • get_dataset_opt_in_out_urls - URLs d'opt-in/out
  • get_dataset_presidio_entities - Detecció d'entitats PII

Inici ràpid

Integració amb Claude Desktop

Afegeix a la teva configuració claude_desktop_config.json:

{
  "mcpServers": {
    "huggingface-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--name", "huggingface-mcp-claude",
        "huggingface-mcp:latest"
      ]
    }
  }
}

Construir imatge Docker

make docker-build

Desenvolupament

Requisits previos

• Python 3.12+
• uv

Instal·lació

make install    # Instal·la les dependències
make test       # Executa les proves (38 proves)
make example    # Prova totes les eines
make run        # Inicia el servidor directament

Comandes Docker

make docker-build    # Construir imatge
make docker-run      # Executar contenidor
make docker-stop     # Aturar contenidor

Cobertura de l'API

Implementa tots els punts finalitzadors GET de l'Hugging Face Dataset Viewer API:

Construït amb FastMCP seguint totes les millors pràctiques de desenvolupament.

Configuració

Copia el fitxer d'exemple d'entorn i configura segons sigui necessari:

cp .env.example .env
# Edita .env amb la teva configuració

Ús

Iniciar el servidor

make run

Executar proves

make test

Executar exemples

make example

Docker

Construir i executar

make docker-build
make docker-run

Amb Docker Compose

Instal\u00b7lem i gestionem el teu servidor MCP
El nostre equip configura, desplega i manté servidors MCP adaptats a la teva infraestructura.
 Instal\u00b7lació i configuració professional
 Integració amb els teus sistemes existents
 Suport tècnic i manteniment continu
 Seguretat i auditoria personalitzada
 Resposta en menys de 24h · Sense compromís
Consulta ràpida sobre MCP
 Instal\u00b7lem i gestionem el teu servidor MCP - Hugging Face 
 Accepto la política de privacitat
 Enviar consulta MCP