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サーバーは、毎回コールドスタートから始まります。
目次
- Hugging Face SpacesでMCPサーバーをホストするとは
- 2026年に無料Spacesで何が変わったか
- MCPサーバーから見たハードウェア・スリープ・費用
- サーバーを作る:mcp_server=TrueのGradioアプリ
- Spaceにデプロイする
- Gradio 6.32での計測結果
- Claude Code・Cursor・Claude・自作エージェントからの接続
- Spacesと汎用のMCPホストの使い分け
- 公開前チェックリスト
- よくあるハマりどころ(症状→原因→対処)
- NodeFlareならこう解決できる
- 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にデプロイする
- Gradio SDKでSpaceを作ります。無料アカウントならハードウェアにZeroGPUを選びます。PROなら、CPUだけのツールはCPU Basicで足ります。
app.pyとrequirements.txtをpushします。Spaceがビルドされて起動します。- ツールが使うAPIキーは、Settingsの「Variables and secrets」にSecretとして登録します。Secretは保存後に表示されず、Spaceを複製されてもコピーされません。Variableは公開されます。
- Spaceを開き、フッターのAPIのリンクからMCPの項目を開くと、正確なURLとクライアント用の設定が表示されます。
- クライアントなしでツール一覧を確かめるには、
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とエグレス込み)です。
最小の始め方:
- GitHubでサインインし、MCPサーバーのリポジトリを選ぶ。
- 必要ならAPIキーなどの環境変数を入れてデプロイする。
- 発行された
https://<your-server>.nodeflare.tech/mcpのURLとAPIキーを、Claude・Cursor・自作エージェントに設定する。
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向けのホストに置くのが現実的です。
参考資料
- Gradio: Building an MCP Server with Gradio
- Gradioのソースコード(GitHub: gradio-app/gradio)
- Hugging Face Docs: Spaces Overview
- Hugging Face Docs: Using GPU Spaces(ハードウェア・スリープ・課金)
- Hugging Face Docs: Spaces ZeroGPU
- Hugging Face Docs: Spaces storage
- Hugging Face Docs: Hugging Face MCP Server
- Hugging Face Blog: How to Build an MCP Server in 5 Lines of Python
- Hugging Face: Pricing
- HFフォーラム:無料CPU Basic Spacesに関する利用者スレッド(2026年7〜9月)
- MCP仕様 2026-07-28: Transports
- NodeFlare Docs
