数据集查询服务

拥抱脸部MCP服务器

MCP服务器提供对 拥抱面部数据集查看器API查询数据集，探索数据，搜索内容，并分析Hugging Face Hub广泛收集的机器学习数据集中的统计数据。

特性

• 12个MCP工具 涵盖所有API端点：
  • get_dataset_splits -数据集拆分信息
  • get_dataset_info -数据集元数据和特征
  • get_dataset_first_rows -预览前100行
  • get_dataset_rows -分页数据访问
  • search_dataset -数据集中的全文搜索
  • get_dataset_size -数据集大小信息
  • get_dataset_statistics -统计分析
  • filter_dataset -类似SQL的数据过滤
  • check_dataset_validity -数据集验证
  • get_dataset_parquet -拼花文件信息
  • get_dataset_opt_in_out_urls -选择加入/退出URL
  • get_dataset_presidio_entities -PII实体检测

快速开始

Claude桌面集成

添加到您的Claude桌面 claude_desktop_config.json:

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

构建Docker镜像

make docker-build

发展

先决条件

• Python 3.12+
• 紫外线

设置

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

Docker命令

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

API覆盖范围

实现来自的所有GET端点 拥抱面部数据集查看器API:

内置于 FastMCP 遵循所有开发最佳实践。

配置

复制示例环境文件并根据需要进行配置：

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

用法

运行服务器

make run

运行测试

make test

运行示例

make example

码头工人

构建并运行

make docker-build
make docker-run

使用Docker Compose

docker-compose up --build

发展

TODO：添加开发指南

API文档

所有：添加API文档

贡献

TODO：添加贡献指南

许可证

TODO:添加许可证信息