Servidor MCP de Hugging Face

Servidor MCP que proporciona acceso a la API del visor de conjuntos de datos de Hugging Face. Consulte conjuntos de datos, explore datos, busque contenido y analice estadísticas de la amplia colección de conjuntos de datos de aprendizaje automático de Hugging Face Hub.

Características

• 12 herramientas MCP que cubren todos los puntos finales de la API
  • get_dataset_splits - Información sobre divisiones de conjuntos de datos
  • get_dataset_info - Metadatos y características del conjunto de datos
  • get_dataset_first_rows - Vista previa de las 100 primeras filas
  • get_dataset_rows - Acceso a datos paginados
  • search_dataset - Búsqueda de texto completo en conjuntos de datos
  • get_dataset_size - Información sobre el tamaño del conjunto de datos
  • get_dataset_statistics - Análisis estadístico
  • filter_dataset - Filtrado de datos tipo SQL
  • check_dataset_validity - Validación de conjuntos de datos
  • get_dataset_parquet - Información del archivo Parquet
  • get_dataset_opt_in_out_urls - URLs de entrada/salida
  • get_dataset_presidio_entities - Detección de entidades PII

Inicio rápido

Integración con Claude Desktop

Añada a su Claude Desktop claude_desktop_config.json:

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

Crear imagen Docker

make docker-build

Desarrollo

Requisitos previos

• Python 3.12+
• uv

Configuración

make install # Instalar dependencias make test # Ejecutar pruebas (38 pruebas) make example # Probar todas las herramientas make run # Iniciar servidor directamente

Comandos Docker

make docker-build # Construir imagen make docker-run # Ejecutar contenedor make docker-stop # Detener contenedor

Cobertura de la API

Implementa todos los puntos finales GET de la API Hugging Face Dataset Viewer:

Construido con FastMCP siguiendo todas las mejores prácticas de desarrollo.

Configuración

Copie el archivo de entorno de ejemplo y configure según sea necesario:

cp .env.ejemplo .env # Edite .env con su configuración

Uso

Ejecutando el Servidor

make run

Ejecución de pruebas

make test

Ejecutar ejemplos

make ejemplo

Docker

Construir y ejecutar

make docker-build make docker-run

Con Docker Compose

docker-compose up --build

Desarrollo

TODO: Añadir directrices de desarrollo

Documentación API

TODO: Añadir documentación API

Contribuyendo

TODO: Añadir directrices de contribución

Licencia

TODO: Añadir información sobre la licencia