Hugging Face

Servidor MCP Hugging Face

Servidor MCP que fornece acesso à Hugging Face Dataset Viewer API. Consulte datasets, explore dados, pesquise conteúdo e analise estatísticas da extensa coleção de datasets de aprendizado de máquina do Hugging Face Hub.

Recursos

• 12 Ferramentas MCP cobrindo todos os endpoints da API:
  • get_dataset_splits - Informações de divisões do dataset
  • get_dataset_info - Metadados e recursos do dataset
  • get_dataset_first_rows - Visualizar as primeiras 100 linhas
  • get_dataset_rows - Acesso paginado aos dados
  • search_dataset - Pesquisa de texto completo em datasets
  • get_dataset_size - Informações de tamanho do dataset
  • get_dataset_statistics - Análise estatística
  • filter_dataset - Filtragem de dados estilo SQL
  • check_dataset_validity - Validação de dataset
  • get_dataset_parquet - Informações de arquivos Parquet
  • get_dataset_opt_in_out_urls - URLs de opt-in/opt-out
  • get_dataset_presidio_entities - Detecção de entidades PII

Início Rápido

Integração com Claude Desktop

Adicione ao seu Claude Desktop claude_desktop_config.json:

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

Construir Imagem Docker

make docker-build

Desenvolvimento

Pré-requisitos

• Python 3.12+
• uv

Configuração

make install    # Install dependencies
make test       # Run tests (38 tests)
make example    # Test all tools
make run        # Start server directly

Comandos Docker

make docker-build    # Build image
make docker-run      # Run container
make docker-stop     # Stop container

Cobertura da API

Implementa todos os endpoints GET da Hugging Face Dataset Viewer API:

Endpoint	Ferramenta	Descrição
/splits	get_dataset_splits	Informações de divisões do dataset
/info	get_dataset_info	Metadados e recursos do dataset
/first-rows	get_dataset_first_rows	Visualizar as primeiras 100 linhas
/rows	get_dataset_rows	Acesso paginado aos dados
/search	search_dataset	Pesquisa de texto completo em datasets
/size	get_dataset_size	Informações de tamanho do dataset
/statistics	get_dataset_statistics	Análise estatística
/filter	filter_dataset	Filtragem de dados estilo SQL
/is-valid	check_dataset_validity	Validação de dataset
/parquet	get_dataset_parquet	Informações de arquivos Parquet
/opt-in-out-urls	get_dataset_opt_in_out_urls	URLs de opt-in/opt-out
/presidio-entities	get_dataset_presidio_entities	Detecção de entidades PII

Construído com FastMCP seguindo todas as melhores práticas de desenvolvimento.

Configuração

Copie o arquivo de ambiente de exemplo e configure conforme necessário:

cp .env.example .env
# Edit .env with your configuration

Uso

Executando o Servidor

make run

Executando Testes

make test

Executando Exemplos

make example

Docker

Construir e Executar

make docker-build
make docker-run

Com Docker Compose

docker-compose up --build

Desenvolvimento

TODO: Adicionar diretrizes de desenvolvimento

Documentação da API

TODO: Adicionar documentação da API

Contribuição

TODO: Adicionar diretrizes de contribuição

Licença

TODO: Adicionar informações de licença