[!ヒント]

Hugging Face MCPサービスにはhttps://hf.co/mcp,で直接アクセス・設定できます。Gradioスペースも含まれます。

このプロジェクトは公式のHugging Face MCP ServerおよびGradio MCP Endpointsに置き換えられています。

あるいは、hf-mcp-serverをローカルでSTDIOサーバーとして実行するか、SSE、ストリーミングHTTP、ストリーミングHTTPのJSON Modeを強固にサポートすることもできます。これにより、ツールやエンドポイントの選択のためのローカルUIも動作し、ToolListChangedNotificationsもサポートされています。

hf.co/mcp

MCP-HFスペース

序文はこちらで読め llmindset.co.uk/resources/mcp-hfspace/

最小限のセットアップでHugging Face Spacesに接続しましょう。スペースを追加するだけですぐに始めましょう!

デフォルトでは、black-forest-labs/FLUX.1-schnellに接続されており、Claude Desktopに画像生成機能を提供します。

Gradio MCPサポート

[!ヒント] Gradio 5.28はSSE経由でMCPサポートを統合しました:https://huggingface.co/blog/gradio-mcp. ターゲットスペースがMCP対応かどうか確認してください!

設置

NPMパッケージは@llmindset/mcp-hfspace。

プラットフォーム用の最新バージョンのNodeJSをインストールし、その後、claude_desktop_config.jsonファイルのmcpServersセクションに以下を追加してください:

mcp-hfspace MCP Server 🤗

[!TIP]

You can access and configure Hugging Face MCP services directly at https://hf.co/mcp, including Gradio spaces.

This project has been superceded by the official Hugging Face MCP Server and Gradio MCP Endpoints.

Alternatively you can run hf-mcp-server locally as a STDIO Server, or with robust support for SSE, Streaming HTTP and Streaming HTTP JSON Mode. This also runs a local UI for selecting tools and endpoints and supports ToolListChangedNotifications too.

hf.co/mcp

mcp-hfspace

Read the introduction here llmindset.co.uk/resources/mcp-hfspace/

Connect to Hugging Face Spaces with minimal setup needed - simply add your spaces and go!

By default, it connects to black-forest-labs/FLUX.1-schnell providing Image Generation capabilities to Claude Desktop.

Gradio MCP Support

[!TIP] Gradio 5.28 now has integrated MCP Support via SSE: https://huggingface.co/blog/gradio-mcp. Check out whether your target Space is MCP Enabled!

Installation

NPM Package is @llmindset/mcp-hfspace.

Install a recent version of NodeJS for your platform, then add the following to the mcpServers section of your claude_desktop_config.json file:

    "mcp-hfspace": {
      "command": "npx",
      "args": [
        "-y",
        "@llmindset/mcp-hfspace"
      ]
    }

Please make sure you are using Claude Desktop 0.78 or greater.

This will get you started with an Image Generator.

Basic setup

Supply a list of HuggingFace spaces in the arguments. mcp-hfspace will find the most appropriate endpoint and automatically configure it for usage. An example claude_desktop_config.json is supplied below.

By default the current working directory is used for file upload/download. On Windows this is a read/write folder at \users\\AppData\Roaming\Claude\<version.number\, and on MacOS it is the is the read-only root: /.

It is recommended to override this and set a Working Directory for handling the upload and download of images and other file-based content. Specify either the --work-dir=/your_directory argument or MCP_HF_WORK_DIR environment variable.

An example configuration for using a modern image generator, vision model and text to speech, with a working directory set is below:

    "mcp-hfspace": {
      "command": "npx",
      "args": [
        "-y",
        "@llmindset/mcp-hfspace",
        "--work-dir=/Users/evalstate/mcp-store",
        "shuttleai/shuttle-jaguar",
        "styletts2/styletts2",
        "Qwen/QVQ-72B-preview"
      ]
    }