Hf MCP Server (hf-mcp-server)

hf-mcp-server

Produkcyjny serwer MCP do zarządzania HuggingFace Hub, wystawiony przez Streamable HTTP na porcie 8000.

🚀 Quickstart

git clone https://github.com/arturwyroslak/hf-mcp-server
cd hf-mcp-server
cp .env.example .env
# wpisz swój HF_TOKEN w .env

docker compose build
docker compose up -d

Serwer będzie dostępny pod:

http://localhost:8000/mcp

⚙️ Konfiguracja

HF_TOKEN=hf_xxxxxxxx          # wymagany
HF_READ_ONLY=false            # true = tylko odczyt
HF_ADMIN_MODE=false           # true = włącza delete repo
MCP_HOST=0.0.0.0              # adres nasłuchu
MCP_PORT=8000                 # port HTTP
MCP_PATH=/mcp                 # ścieżka endpointu

🌍 Ustawienie domeny

Port: 8000 Endpoint: /mcp Docelowy URL: https://mcp.twojadomena.pl/mcp

Nginx reverse proxy

server {
    server_name mcp.twojadomena.pl;

    location /mcp {
        proxy_pass         http://127.0.0.1:8000/mcp;
        proxy_http_version 1.1;
        proxy_set_header   Host              $host;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_buffering    off;
        proxy_read_timeout 300s;
    }
}

certbot --nginx -d mcp.twojadomena.pl

Caddy (automatyczny SSL)

mcp.twojadomena.pl {
    reverse_proxy /mcp localhost:8000
}

🔌 Podłączenie klientów MCP

Claude Desktop

Edytuj ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hf-mcp": {
      "type": "http",
      "url": "https://mcp.twojadomena.pl/mcp"
    }
  }
}

Cursor

Edytuj ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hf-mcp": {
      "type": "http",
      "url": "https://mcp.twojadomena.pl/mcp"
    }
  }
}

VS Code / Continue

{
  "mcp": {
    "servers": {
      "hf-mcp": {
        "type": "http",
        "url": "https://mcp.twojadomena.pl/mcp"
      }
    }
  }
}

Python (OpenAI Agents SDK)

from agents.mcp import MCPServerStreamableHttp

server = MCPServerStreamableHttp(
    name="hf-mcp",
    params={"url": "https://mcp.twojadomena.pl/mcp", "timeout": 30},
)

🐳 Docker commands

# Zbuduj
docker compose build

# Uruchom w tle
docker compose up -d

# Sprawdź logi
docker compose logs -f hf-mcp

# Rebuild bez cache
docker compose build --no-cache

# Zatrzymaj
docker compose down

🛠️ Narzędzia (12)

Szczegółowa dokumentacja → TOOLS.md

📄 Licencja

MIT