README.md•2.05 kB
# Hugging Face Hub MCP Server
A Model Context Protocol (MCP) server that provides access to the Hugging Face Hub API, allowing you to search and retrieve information about models, datasets, and their metadata.
## Features
- **Models API**: Search models, get detailed model info, and retrieve model tags
- **Datasets API**: Search datasets, get dataset info, access parquet files, and Croissant metadata
- **Full Hub Integration**: Access all public repositories and metadata from Hugging Face Hub
## Tools
### Models
- `hf_list_models` - List and search models with filtering options
- `hf_get_model_info` - Get detailed information about a specific model
- `hf_get_model_tags` - Get all available model tags
### Datasets
- `hf_list_datasets` - List and search datasets with filtering options
- `hf_get_dataset_info` - Get detailed information about a specific dataset
- `hf_get_dataset_parquet` - Get parquet file information for datasets
- `hf_get_croissant` - Get Croissant metadata for datasets
- `hf_get_dataset_tags` - Get all available dataset tags
## Installation
```bash
npm install
npm run build
```
## Usage
### STDIO (for Claude Desktop)
```bash
npm run dev:stdio
```
### HTTP Server
```bash
npm run dev:shttp
# or specify port
npm start --port 3003
```
## Configuration
The server uses the Hugging Face Hub public API endpoints. No authentication is required for public repositories.
Environment variables:
- `HF_BASE_URL`: Base URL for Hugging Face API (default: https://huggingface.co)
- `PORT`: HTTP server port (default: 3003)
## Examples
Search for text classification models:
```javascript
{
"name": "hf_list_models",
"arguments": {
"filter": "text-classification",
"limit": 10
}
}
```
Get information about a specific model:
```javascript
{
"name": "hf_get_model_info",
"arguments": {
"repo_id": "microsoft/DialoGPT-medium"
}
}
```
Search for datasets by author:
```javascript
{
"name": "hf_list_datasets",
"arguments": {
"author": "huggingface",
"limit": 5
}
}
```