記事一覧
MCPホスティング

Hugging Face SpacesはまだMCP Hostingに無料で使える?Gradioのmcp_server=Trueを2026年の有料化後に検証(Gradio 6.32)

2026年のHugging Face SpacesでのMCP Hosting。新規のGradio SpaceはZeroGPU以外PROが必要、無料ハードウェアは48時間でスリープ、Gradioのキューは既定で1件ずつ。Gradio 6.32で検証した /gradio_api/mcp/ の使い方、188 MB・1回約60 msの実測、Space名の接頭辞、ZeroGPUの上限、費用、Claude Code・Cursorの接続を解説。

最終更新:2026年11月17日 / 対象:Gradio 6.32.0(MCP extraはMCP Python SDKを2.0未満に固定。検証はmcp 1.30.0)、2026年11月17日時点のHugging Face SpacesとZeroGPUの公式ドキュメント、MCP仕様 2026-07-28。料金と制限はHugging Faceのドキュメントと料金ページから引用しています。時間とメモリの数値は私たちの計測です(方法は6章)。

結論(30秒で読める要約)

Hugging Face SpacesでのMCP Hostingとは、Gradioアプリを mcp_server=True で起動してSpaceに置き、説明付きのPython関数をそのままMCPのツールとして https://<user>-<space>.hf.space/gradio_api/mcp/ で公開することです。仕組みとしては今も便利に使えます。2026年に変わったのは「無料かどうか」です。

アカウント SpacesでGradioのMCPサーバーを立てられるか ハードウェア 月額
無料 ZeroGPUのみ。最大2つ。メール認証済みで作成30日以上のアカウント ZeroGPU(GPU時間は1日の上限あり) $0
PRO CPU Basic、ZeroGPU(最大10)、有料ハードウェアで可 CPU Basic:2 vCPU・16 GB RAM $9(PRO代)
PRO+常時起動のCPU 可 CPU Upgrade:8 vCPU・32 GB RAM $9+約$22
PRO+GPU 可 例:T4 small $9+約$288

「Hugging Faceで無料のMCPサーバー」系の記事の多くが、いま次の4点で古くなっています。

  • 無料の範囲が変わりました。Spacesの公式ドキュメントには「Gradio and Docker Spaces run on compute and require a paid plan to create」とあります。例外は、無料アカウントでもZeroGPU上のGradio Spaceを2つまで置けることです。以前に作った無料のCPU Basic Spaceは動き続けている、という利用者の報告がフォーラムにあります。
  • エンドポイントは /sse ではありません。Gradio 6.32は起動時に /gradio_api/mcp/ で終わるStreamable HTTPのURLを表示します。古い記事は /gradio_api/mcp/sse と mcp-remote を使っています。SSEのパスもまだ応答しますが、今のクライアントはStreamable HTTPのURLに直接つなげます。
  • 既定では1件ずつしか処理しません。Gradioのキューは関数ごとに concurrency_limit=1 で動きます。私たちの計測では、2秒かかるツールを3件同時に呼ぶと2.1秒・4.1秒・6.1秒で返りました。demo.queue(default_concurrency_limit=3) にすると3件とも約2.1秒でした。
  • 無料ハードウェアは48時間アクセスがないとスリープし、再起動でディスクの中身が消えます。週に1回しか呼ばれないMCPサーバーは、毎回コールドスタートから始まります。

目次

  1. Hugging Face SpacesでMCPサーバーをホストするとは
  2. 2026年に無料Spacesで何が変わったか
  3. MCPサーバーから見たハードウェア・スリープ・費用
  4. サーバーを作る:mcp_server=TrueのGradioアプリ
  5. Spaceにデプロイする
  6. Gradio 6.32での計測結果
  7. Claude Code・Cursor・Claude・自作エージェントからの接続
  8. Spacesと汎用のMCPホストの使い分け
  9. 公開前チェックリスト
  10. よくあるハマりどころ(症状→原因→対処)
  11. NodeFlareならこう解決できる
  12. FAQ

1. Hugging Face SpacesでMCPサーバーをホストするとは

Hugging Face SpacesでMCPサーバーをホストするとは、GradioアプリをSpaces上で動かし、Gradioに組み込まれたMCPサーバー機能をオンにして、Claude・Cursor・自作エージェントなどのMCP(Model Context Protocol)クライアントからアプリの関数をツールとしてHTTPSで呼べるようにすることです。

このブログで扱ってきた他のMCP Hostingとは、次の3点が違います。

  • MCPサーバーを書く必要がありません。Gradioが自動で作ります。関数名がツール名(Space上ではSpace名の接頭辞付き)、docstringが説明、型ヒントが inputSchema になります。
  • PythonとGradioに限られます。GitHubで見つけたstdioのMCPサーバーをGradio Spaceにそのまま置くことはできません。その場合はDocker Spaceにブリッジを入れるか、別のホストを使います(stdioのMCPサーバーをリモートで動かす手順を参照)。
  • GPUがすぐ使えます。GPUとZeroGPUを持つMCPの置き場所はSpacesくらいです。画像生成、文字起こし、OCR、埋め込みのように、モデルを動かすツールには自然な選択肢です。

2. 2026年に無料Spacesで何が変わったか

新しくGradioやDockerのSpaceを作るには、ZeroGPUを使う場合を除いて有料プランが必要になりました。Spacesの概要ドキュメントは「Static Spaces are free for everyone. Gradio and Docker Spaces run on compute and require a paid plan to create.」と書き、例外として、条件を満たす無料の個人アカウントはZeroGPU上のGradio Spaceを2つまで置けるとしています。

Hugging Faceのフォーラムで利用者が報告している内容は次のとおりです(公式発表ではなく利用者の報告です)。

  • 2026年7月9日〜15日のスレッドで、新しい無料アカウントがCPU BasicのGradio Spaceを作れなくなった、作成画面でGradio SDKに「Paid」と表示される、という報告が続きました。
  • 2026年9月5日には、2026年6月より前に作ったGradio SpaceはCPU Basicで動き続けている一方、新規作成は無料のcpu-basicでのGradio・Docker Spaceには「requires a PRO subscription」というメッセージで断られた、という報告がありました。
  • 2026年8月〜9月には、停止したSpaceを再開しようとすると「403 You've reached your cpu-basic quota limit」が出るという報告が複数あり、9月21日の返信では有料プランが必要だとしてPROを案内しています。

MCP Hostingの観点では、次のように判断します。

状況 どうするか
以前に作った無料CPU Basicの mcp_server=True のSpaceがある 利用者の報告では動き続けています。削除して作り直すと、新しいSpaceにはPROが必要になります
無料アカウントで、ツールにGPUが必要 ZeroGPUのSpaceを使います(最大2つ)。ZeroGPU Spaceの利用自体は無料です
無料アカウントで、ツールはCPUだけで足りる ZeroGPUのSpaceでも動きますが、使わないGPUを確保することになります。汎用のMCPホストが合う場合もあります(8章)
PRO(月$9)を契約している CPU Basicを無料で動かせます。ZeroGPUのSpaceも10個まで置けます

2025年に書かれた解説の多くは、Hugging Face自身のブログも含め、Gradioアプリを無料で公開すれば「free hosted MCP server」になると書いています。新しい無料アカウントでは、今それが当てはまるのはZeroGPUだけです。

3. MCPサーバーから見たハードウェア・スリープ・費用

CPUだけで動くMCPサーバーならCPU Basicで足ります。公式ドキュメントでは、Spacesの環境は既定で16 GB RAM・2 CPUコア・50 GBの非永続ディスクです。一般的なMCPサーバーには十分すぎる量で、私たちのGradioサーバーは188 MBでした。

ハードウェア vCPU RAM GPUメモリ 1時間あたり 常時起動した場合の月額
CPU Basic 2 16 GB – 無料(新規のGradio SpaceはPROが必要) $0
CPU Upgrade 8 32 GB – $0.03 約$22
ZeroGPU 動的 – 最大96 GB(xlarge) 無料。1日の上限あり $0
Nvidia T4 small 4 15 GB 16 GB $0.40 約$288
1x L4 8 30 GB 24 GB $0.80 約$576
A10G small 4 15 GB 24 GB $1.00 約$720

月額は1時間あたりの料金×720時間です。CPU Upgrade($22)とT4 small($288)は料金ページの月額表示と一致します。

スリープと復帰

  • 無料ハードウェアはスリープします。公式ドキュメントでは、無料ハードウェアのSpaceは「inactive for more than a set time (currently, 48 hours)」でスリープし、次の訪問で起きます。
  • 有料ハードウェアは既定ではスリープしません。スリープまでの時間を自分で設定でき、スリープ中は課金されません。
  • 課金は分単位です。SpaceがStartingかRunningの間は、呼ばれていなくても課金されます。ビルド中は課金されません。

MCPで問題になるのは「訪問」の扱いです。週に1回だけツールを呼ぶエージェントは、たいていスリープ中のSpaceに当たります。復帰にかかる時間は公式に書かれていません。私たちの計測では、Pythonのプロセスだけで、Gradioを読み込んで応答できるまで5.2秒かかりました。これにSpaces側のコンテナ起動が加わります。クライアントがSpaceの復帰より先に initialize をあきらめると、呼び出しは失敗します。クライアント側のタイムアウトについてはMCPサーバーのコールドスタート対策を参照してください。

ZeroGPUの1日の上限

ZeroGPUは、@spaces.GPU を付けた関数が動いている間だけSpaceにGPUを割り当てます。ZeroGPUのドキュメントにある1日の上限は次のとおりです。

呼び出す人 1日のGPU時間 キューの優先度
未ログイン 2分 低
無料アカウント 5分 中
PRO 40分(追加可) 最高
Teamのメンバー 40分(追加可) 最高
Enterpriseのメンバー 60分(追加可) 最高

上限は最初にGPUを使ってから24時間後にリセットされます。PRO・Team・Enterpriseは「$1 per 10 minutes」で追加できます。1回あたりの duration は既定で60秒で、短く指定するとキューの優先度が上がるとドキュメントにあります。ZeroGPUが使えるのはGradio SDKだけです。

ドキュメントに書かれていないこともあります。Hugging Faceのトークンを付けずに届いたMCPのツール呼び出しが、誰の上限を消費するかです。上限は呼び出す人ごとなので、1日に何回呼べるかを約束する前に、トークンあり・なしの両方で試してください。

ディスク

既定のディスクは一時的なもので、「its content will be lost if your Space restarts or is stopped」と書かれています。ツールが覚えておくべきデータは、Storage Bucketをボリュームとしてマウントして保存します。他のホストでの同じ問題は永続ストレージの記事で扱っています。

4. サーバーを作る:mcp_server=TrueのGradioアプリ

GradioのMCPサーバーは、型ヒントとdocstringを付けた関数を持つ普通のGradioアプリに、launch() の mcp_server=True を足したものです。検証に使ったアプリは次のとおりです。

# app.py
import time
import gradio as gr

def letter_counter(word: str, letter: str) -> int:
    """Count how many times a letter appears in a word.

    Args:
        word: The word to search in.
        letter: The letter to count.
    """
    return word.lower().count(letter.lower())

def slow_job(seconds: float, progress=gr.Progress()) -> str:
    """Sleep for N seconds while reporting progress.

    Args:
        seconds: How long to work.
    """
    n = int(seconds)
    for i in range(n):
        progress((i + 1) / n, desc=f"step {i + 1}")
        time.sleep(1)
    return f"done after {n}s"

with gr.Blocks() as demo:
    gr.Interface(letter_counter, ["text", "text"], "number", api_name="letter_counter")
    gr.Interface(slow_job, "number", "text", api_name="slow_job")

demo.queue(default_concurrency_limit=3)   # 既定は1。呼び出しが1件ずつ並ぶ
demo.launch(mcp_server=True)
# requirements.txt
gradio[mcp]==6.32.0

GradioはこのコードをMCPに次のように変換します。

Gradio側 MCP側
Pythonの関数名(Space上では <Space名>_ が付く) ツール名
docstringの要約 ツールの説明
Args: の各行 inputSchema の各プロパティの description
型ヒント JSON Schemaの型。既定値のない引数は required
gr.Progress() の更新 クライアントへの notifications/progress
ファイル・画像の入力 URLで受け取る。upload_file_to_gradio ツールがあれば使うよう説明文に追記される
@gr.mcp.resource(...)、@gr.mcp.prompt(...) MCPのリソースとプロンプト
@gr.mcp.tool(name=..., description=...) 自動生成された名前と説明を上書き

コードを変えずに、環境変数 GRADIO_MCP_SERVER=True でオンにすることもできます。SpaceではSettingsのVariablesに設定します。

5. Spaceにデプロイする

  1. Gradio SDKでSpaceを作ります。無料アカウントならハードウェアにZeroGPUを選びます。PROなら、CPUだけのツールはCPU Basicで足ります。
  2. app.py と requirements.txt をpushします。Spaceがビルドされて起動します。
  3. ツールが使うAPIキーは、Settingsの「Variables and secrets」にSecretとして登録します。Secretは保存後に表示されず、Spaceを複製されてもコピーされません。Variableは公開されます。
  4. Spaceを開き、フッターのAPIのリンクからMCPの項目を開くと、正確なURLとクライアント用の設定が表示されます。
  5. クライアントなしでツール一覧を確かめるには、https://<user>-<space>.hf.space/gradio_api/mcp/schema を開きます。ツールがJSONで返ります。

エンドポイントは次のとおりです。

エンドポイント URL
Streamable HTTP(こちらを使う) https://<user>-<space>.hf.space/gradio_api/mcp/
旧来のSSE https://<user>-<space>.hf.space/gradio_api/mcp/sse
ツールのスキーマ(JSON) https://<user>-<space>.hf.space/gradio_api/mcp/schema

Spacesから外へ出られるポートは80・443・8080だけです。5432番ポートのデータベースに直接つなぐツールは、Space上では届きません。

6. Gradio 6.32での計測結果

上のアプリをGradio 6.32.0・Python 3.13でローカルに起動し、公式MCP Python SDKのクライアント(mcp 1.30.0)からループバックのStreamable HTTPで呼びました。

計測項目 結果
プロセス起動から最初のHTTP 200まで(パッケージはインストール済み) 5.2秒
initialize の往復 50 ms
合意したプロトコルバージョン 2025-11-25
Mcp-Session-Id 返らない(ステートレスで動作)
宣言されたcapabilities tools・resources・prompts(listChanged なし)
letter_counter の tools/call を5回 81・63・64・64・62 ms
呼び出し後の常駐メモリ(RSS) 188 MB
slow_job 実行中の進捗通知 あり。最初は「In queue. Position 0 out of 1.」
2秒のツールを3件同時、既定のキュー 2.09・4.10・6.07秒(合計6.15秒)
同じく default_concurrency_limit=3 2.09・2.14・2.13秒(合計2.22秒)

ここからわかることは4つです。

  • 中身のない呼び出しでも、サーバー側で約60 msかかります。MCPの呼び出しがGradioのキューを通るためです。数秒かかるモデル系のツールなら気になりませんが、エージェントが何十回も呼ぶ検索系のツールでは効いてきます。
  • キューが同時実行数の上限です。Gradioの既定はイベントごとに1で、環境変数 GRADIO_DEFAULT_CONCURRENCY_LIMIT でも変えられます。2つのエージェントが同じツールを呼ぶと順番待ちになります。CPUのツールでは上げ、GPUのツールではGPUメモリに収まる範囲に抑えます。
  • Space上ではツール名が変わります。Gradioのソースでは、Space上(SPACE_ID が設定された環境)で動くとき、すべてのツール名の前にSpace名が付きます。letters というSpaceの letter_counter は letters_letter_counter になります。ローカルでは付きません。
  • 失うセッションがありません。GradioはStreamable HTTPを stateless=True で動かすので、Spaceが再起動してもクライアントのセッションは壊れません。ただし、関数がPythonのグローバル変数に持っているデータは再起動で消えます。

7. Claude Code・Cursor・Claude・自作エージェントからの接続

どのクライアントもStreamable HTTPのURLを使います。Authorization ヘッダーは非公開のSpaceのときだけ付けます。

Claude Codeの場合:

claude mcp add --transport http letters https://<user>-<space>.hf.space/gradio_api/mcp/
# 非公開のSpace
claude mcp add --transport http letters https://<user>-<space>.hf.space/gradio_api/mcp/ \
  --header "Authorization: Bearer <HF_TOKEN>"

Cursorの場合(~/.cursor/mcp.json):

{
  "mcpServers": {
    "letters": {
      "url": "https://<user>-<space>.hf.space/gradio_api/mcp/",
      "headers": { "Authorization": "Bearer <HF_TOKEN>" }
    }
  }
}

Claude(Web・デスクトップのカスタムコネクタ)の場合:公開SpaceのURLをカスタムコネクタとして登録します。カスタムコネクタは固定ヘッダーではなくOAuthでサインインするため、Hugging Faceのトークンが必要な非公開Spaceは、Claude Code・Cursor・自作エージェントから使う方が確実です。

Hugging FaceのMCPサーバー経由の場合:すでに https://huggingface.co/mcp を使っているなら、huggingface.co/settings/mcp でSpaceを追加し、クライアントを再起動すると、Hubのツールと並んで表示されます。

自作エージェントの場合(MCP Python SDK):

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://<user>-<space>.hf.space/gradio_api/mcp/"
async with streamablehttp_client(URL, headers={"Authorization": "Bearer <HF_TOKEN>"}) as (r, w, _):
    async with ClientSession(r, w) as s:
        await s.initialize()
        # Space上ではツール名にSpace名の接頭辞が付く
        print(await s.call_tool("<space>_letter_counter", {"word": "strawberry", "letter": "r"}))

トークンについて:非公開Spaceに渡すBearerトークンは、Hugging Faceのユーザートークンです。書き込み権限のあるトークンではなく、読み取り専用のfine-grainedトークンを使ってください。鍵の扱い全般はセキュリティカテゴリの記事で扱っています。

8. Spacesと汎用のMCPホストの使い分け

ツールがモデルを動かすならSpacesが最適で、GitHubにある既存のMCPサーバーを置きたいだけなら不向きです。

観点 Hugging Face Spaces 汎用のMCPホスト(コンテナ・マネージド)
GitHubにある既存サーバー(stdio・TypeScript・Go) Docker Spaceとブリッジが必要 多くはそのまま対応
GPUが必要なツール ZeroGPUか有料GPU 用意されていないことが多い
新規アカウントの無料枠 ZeroGPUのSpaceが2つ サービスによる
アイドル時 無料ハードウェアは48時間でスリープ サービスによる。速く復帰するscale to zeroが多い
非公開サーバーの認証 Hugging Faceのトークン ホストにより、クライアントごとのAPIキーやOAuth
ツール単位のアクセス制御 組み込みはなし スコープを持つホストもある
同時実行 Gradioのキュー。既定は関数ごとに1 サーバーの実装しだい
MCP呼び出しのログ Spaceのコンテナログ サービスによる

よくある分け方は、モデルを使うツールだけをSpaces(ZeroGPUかGPU)に置き、残りのMCPサーバーはMCP向けのホストに置く形です。汎用の選択肢はMCPサーバーホスティングのランキングで比較しています。

9. 公開前チェックリスト

  • [ ] そのアカウントでSpaceを作れる(PRO、または無料アカウントでZeroGPU)
  • [ ] requirements.txt で gradio[mcp] を検証したバージョンに固定した
  • [ ] すべてのツール関数に型ヒントと Args: 付きのdocstringがある
  • [ ] /gradio_api/mcp/schema に、公開したいツールだけが並んでいる(内部用のイベントは api_visibility="private")
  • [ ] default_concurrency_limit を意図して設定した(CPUのツールは高め、GPUのツールは低め)
  • [ ] GPUのツールは @spaces.GPU を使い、duration を必要最小限にした
  • [ ] APIキーはVariableではなくSecretに入れた
  • [ ] 非公開の情報に触れるツールなら非公開Spaceにし、呼び出し側は読み取り専用のfine-grainedトークンを使う
  • [ ] 再起動後も残すべきデータはStorage Bucketに置いた
  • [ ] 有料ハードウェアならスリープ時間を設定した(または24時間課金を受け入れた)
  • [ ] クライアントは /gradio_api/mcp/ につないでいる(古い /sse と mcp-remote の設定ではない)
  • [ ] 対応するすべてのクライアントで tools/list と tools/call が通った

10. よくあるハマりどころ(症状→原因→対処)

症状 考えられる原因 対処
Gradio Spaceの作成でCPU Basicを選べない 計算資源を使うGradio Spaceの作成には有料プランが必要になった PROにするか、ZeroGPUを選ぶ(無料アカウントは2つまで)
再開時に「403 You've reached your cpu-basic quota limit」 2026年夏以降、無料アカウントで報告されている PROで解消したという報告がある。またはZeroGPUへ移す
数日呼ばなかった後、initialize がタイムアウトする 無料ハードウェアが48時間でスリープした 復帰後に再試行する、クライアントのタイムアウトを延ばす、有料ハードウェアでスリープ時間を設定する
2つ目のエージェントの呼び出しだけ倍の時間がかかる Gradioのキューが関数ごとに1件ずつ処理している demo.queue(default_concurrency_limit=N) か、イベントごとの concurrency_limit
エージェントが letter_counter を呼ぶが、Spaceは <space>_letter_counter を公開している SPACE_ID がある環境ではツール名にSpace名が付く ローカルの名前ではなく、tools/list か /gradio_api/mcp/schema の名前を使う
ツールの説明や引数の説明が空 docstringか Args: がない Google形式のdocstringを書く
非公開Spaceから401や404が返る トークンのヘッダーがない、または誤り そのSpaceを読めるトークンで Authorization: Bearer <HF_TOKEN> を送る
古い記事の mcp-remote+/sse の設定で失敗する 旧来のSSEとブリッジの組み合わせ /gradio_api/mcp/ に直接つなぐ
「You have exceeded your GPU quota」 ZeroGPUの1日の上限を使い切った duration を短くする、PROの上限、プリペイドのクレジット
再起動後にファイルや状態が消えた ディスクが一時的 Storage Bucketをマウントする
ツールがデータベースにつながらない Spacesの外向き通信は80・443・8080番ポートのみ データベースの前にHTTPSのAPIを置く

11. NodeFlareならこう解決できる

Hugging Face Spacesは、GPUを使うGradioのツールの置き場所としては優れています。NodeFlareはそれ以外のケース、つまり自分で書いた、またはGitHubで見つけたMCPサーバーを、認証付きのStreamable HTTPのURLにするためのMCP専用ホスティングです。NodeFlareのドキュメントにはGPUハードウェアの記載がないため、モデルが重いツールはSpacesに残すのが前提です。そのうえで、この記事で挙げた課題にNodeFlareのドキュメントと料金ページに書かれている機能で対応すると、次のようになります。

Spacesでの課題 NodeFlareでの対応
新規のGradio SpaceはPROが必要で、無料アカウントはZeroGPUだけ Freeプランは¥0で、MCPサーバー1つと月30 GB時間の計算資源
Gradioアプリ専用で、GitHubのstdioサーバーにはDocker Spaceとブリッジが要る GitHubのリポジトリから直接デプロイ(Node・Python・Go・Rust・Java・.NETなど。モノレポのサブディレクトリも可)。stdioアダプターが /mcp でStreamable HTTPと旧来のHTTP+SSEを提供し、本物のMCP initialize(最大8回まで再試行)が通ってから公開扱いになる
無料ハードウェアは48時間でスリープし、コールドスタートから復帰する 数分アイドルが続くとスナップショットを取って停止し、次のリクエストで1秒未満で復元。Always-On(Pro以上)なら常に温まったレプリカを1つ保つ。停止中は¥0
非公開にするとHugging Faceのユーザートークンを渡すことになる すべてのリクエストに mcp_* のAPIキーかOAuth 2.0のアクセストークンが必要。スコープは tools:call:get_weather のようにツール1つ単位まで絞れる
Gradioのキューは既定で関数ごとに1件ずつ アダプターが同時に届いたJSON-RPCのIDを振り直し、複数のクライアントが1つのサーバープロセスを共有できる。同時実行数がレプリカの上限を超えると水平オートスケールでレプリカを追加
ディスクが一時的 ProとTeamで永続ディスク(10 GB込み)
ログはコンテナログだけ MCPメソッド、ツール名、引数のキー名(値は記録しない)、ステータス、結果、duration_ms を記録するリクエストログ。保存期間はFreeで7日、ProとTeamで30日

料金:Freeは¥0でMCPサーバー1つ、月30 GB時間の計算資源。Proは月¥2,980でサーバー数無制限、300 GB時間の計算資源と10 GBのストレージ込み。超過分は1 GB時間あたり¥5(CPUとエグレス込み)です。

最小の始め方:

  1. GitHubでサインインし、MCPサーバーのリポジトリを選ぶ。
  2. 必要ならAPIキーなどの環境変数を入れてデプロイする。
  3. 発行された https://<your-server>.nodeflare.tech/mcp のURLとAPIキーを、Claude・Cursor・自作エージェントに設定する。

1サーバーまで無料でNodeFlareを試す →

12. FAQ

Hugging Face SpacesでMCPサーバーを無料でホストできますか?

条件付きでできます。2026年11月時点の公式ドキュメントでは、新しいGradioとDockerのSpaceには有料プランが必要で、例外として条件を満たす無料アカウントはZeroGPU上のGradio Spaceを2つまで置けます。以前に無料のCPU Basicで作ったGradio Spaceは動き続けている、と利用者が報告しています。

Gradio SpaceのMCPエンドポイントのURLは?

Streamable HTTPは https://<user>-<space>.hf.space/gradio_api/mcp/ です。旧来のSSEは同じパスの末尾に sse を付けたもので、/gradio_api/mcp/schema ではツール一覧がJSONで返ります。

GradioアプリをMCPサーバーにするには?

gradio[mcp] をインストールし、関数に型ヒントと Args: 付きのdocstringを書いて、demo.launch(mcp_server=True) で起動します。コードを変えずに、環境変数 GRADIO_MCP_SERVER=True でもオンにできます。

Hugging Face Spaceに接続するのに、まだmcp-remoteは必要ですか?

Claude Code、Cursor、Claudeのカスタムコネクタのように、リモートのStreamable HTTPサーバーに対応したクライアントなら不要です。古い記事が mcp-remote を使っていたのは、/sse のエンドポイントを指していて、SSEに対応していないクライアントがあったためです。

非公開SpaceのMCPサーバーに接続するには?

Hugging Faceのトークンを Authorization: Bearer <HF_TOKEN> ヘッダーで送ります。読み取り専用のfine-grainedトークンを使ってください。任意のヘッダーを送れないクライアントからは、この方法では接続できません。

Hugging Face SpaceのMCPサーバーはスリープしますか?

無料ハードウェアではスリープします。48時間アクセスがないとスリープし、次のリクエストで起動します。有料ハードウェアは既定ではスリープせず、費用を抑えたい場合はスリープまでの時間を設定できます。

GradioのMCPサーバーで同時に呼ぶと遅いのはなぜですか?

Gradioのキューは関数ごとの同時実行数が既定で1なので、呼び出しが順番待ちになります。私たちの計測では、2秒のツールを3件同時に呼ぶと2秒・4秒・6秒で返り、demo.queue(default_concurrency_limit=3) にすると3件とも約2秒で返りました。

MCPのツール呼び出しにZeroGPUはどれくらい使えますか?

ZeroGPUのドキュメントでは、1日あたり未ログインで2分、無料アカウントで5分、PROとTeamで40分、Enterpriseで60分です。PRO以上は10分あたり$1で追加できます。トークンなしのツール呼び出しが誰の上限を使うかは書かれていないので、実際に試してください。

GitHubのstdioのMCPサーバーをHugging Face Spacesで動かせますか?

Gradio Spaceではできません。stdioをHTTPに変えるブリッジを入れたDocker Spaceなら可能ですが、新規作成には有料プランが必要で、外向き通信も80・443・8080番ポートに限られます。

Hugging Face Spaces上だとGradioのMCPツール名に接頭辞が付くのはなぜですか?

GradioはSpace上で動くとき、ツール名の前にSpace名とアンダースコアを付けます。letters というSpaceの letter_counter は letters_letter_counter として公開されます。正しい名前は tools/list か /gradio_api/mcp/schema で確認してください。

GradioのMCPサーバーはステートフルですか?

いいえ。GradioはStreamable HTTPのエンドポイントをステートレスで動かし、Mcp-Session-Id を返さないので、再起動してもクライアントのセッションは壊れません。ただし、関数がメモリや既定のディスクに持っているデータは再起動で消えます。

まとめ

Hugging Face Spacesでは、フラグ1つでGradioアプリがMCPサーバーになり、私たちの計測では速く(1回約60 ms)、小さく(188 MB)、ステートレスでした。2026年の注意点は使える条件です。新しいGradio SpaceはZeroGPUでない限りPROが必要で、無料ハードウェアは48時間でスリープし、ディスクは一時的で、Gradioのキューは default_concurrency_limit を上げるまで呼び出しを1件ずつ処理します。モデルを使うツールにはSpacesを使い、クライアントは古い /sse の設定ではなく /gradio_api/mcp/ につなぎ、GitHubにある普通のMCPサーバーはMCP向けのホストに置くのが現実的です。

参考資料

NodeFlare

MCP専用ホスティングサービス

GitHubにあるMCPを簡単デプロイ・簡単運用で最適化
無料で始める

他の記事

MCPトークン2026年11月17日

ツール引数は出力トークン:MCPのトークン消費で見落とされる「書く側」のコスト(write_fileとedit_fileを実測・2026年版)

MCPのツール引数は出力トークンで、単価は入力の5倍、キャッシュも効きません。公式Filesystemサーバーで1行の変更がwrite_file 5,549トークン対edit_file 49トークンになった実測、Sonnet 5.5・Opus 5.5・Fable 5.2での料金試算、ツール間の書き写し、max_tokensでの中断、書き直しの損益分岐、置換ツールのコードまで。

MCPセキュリティ2026年11月17日

MCPのきめ細かな認可:スコープでは防げないBOLAを、オブジェクト・引数・項目単位のチェックで止める【MCP Security 2026】

ツール単位のスコープでは防げない、MCPツールのオブジェクト・引数・項目単位の認可を解説。仕様の「スコープだけで十分とみなすのは誤り」、公式Python SDKを含む2026年のCVE3件、チェックの置き場所、8つのルール、検証済みPythonコード(スコープのみ4/14、多層14/14)とCedarポリシー(12/12)。

MCPトークン2026年11月16日

MCPのトークン消費とAPIレート制限:ツール定義がITPMを食う仕組みと、同時に回せるエージェント数の計算【2026年版】

MCPのツール定義がClaude APIのレート制限(ITPM)をどう消費するかを解説。キャッシュ読み込みは数えない仕組み、Sonnet 5.5・Fable 5.2のティア別上限、1分あたりのタスク数の計算式と試算(約5件対約380件)、ランプ制限の429、ヘッダー記録のコードまで。