Hub documentation
Hugging Face MCP Server
Hugging Face MCP Server
Hugging Face MCP (Model Context Protocol) Server は、MCP 対応の AI アシスタント（Codex、Cursor、VS Code 拡張機能、Zed、ChatGPT、Claude Desktop など）を Hugging Face Hub に直接接続します。接続後、エディター、チャット、CLI のいずれからでも、Hub のリソースを検索・探索し、コミュニティのツールを利用できます。
実行可能なこと
- Hubのリソース（モデル、データセット、Spaces、論文など）を検索して探索します。
- 自然言語のクエリで Hugging Face のドキュメントを検索できます。
- ジョブのスケジュール設定と実行、サンドボックスの利用
- SpacesでホストされているMCP互換のGradioアプリを通じて、コミュニティツールを実行します。
- メタデータ、リンク、コンテキストを付与して、結果をアシスタントに返します。
はじめる
ログイン中にMCP設定を開きます。
クライアントを選択: MCP互換のクライアント（Cursor、VS Code、Zed、Claude Desktopなど）を選択してください。ページには、クライアント固有の手順と、コピーしてすぐに使用できる設定スニペットが表示されます。
貼り付けて再起動: スニペットをクライアントのMCP設定にコピーし、保存して、クライアントを再起動/リロードしてください。クライアント内で「Hugging Face」（またはそれに類似した名称）が接続されたMCPサーバーとして一覧に表示されるはずです。
設定ページは、クライアントが期待する正確な設定を生成します。手動で設定を書く代わりに、これを使用してください。
サーバーの使用
接続後、アシスタントにHugging Faceツールを使用するように指示してください。プロンプトの例:
- “Hugging FaceのモデルでQwen 3.6のQuantizationsを検索します。”
- 音声ファイルを文字起こしできるSpaceを探します。
- “気象の時間系列に関するデータセットを表示します。”
- “Create a 1024 x 1024 image of a cat ghibli style.”
- 「PEFTでLoRAアダプターをどのように使用すればよいですか？」（Documentation Semantic Searchを使用）
- “ビジョン・言語モデルに関する論文を検索します。”
アシスタントは、MCP Server が公開するツール（次のセクションで示すように、選択した Spaces を含む）を使用して Hub をナビゲートし、結果（タイトル、所有者、ダウンロード数、リンクなど）を返します。その後、Hub でそのリソースを開くか、同じチャットで反復を続けることができます。
組み込みツール
Hubのほとんどのタスクは、組み込みのhf_fsツールで効率的に完了できます。このツールにより、アシスタントはDocumentsやSpacesのセマンティック検索を含むHubを効率的にナビゲートできます。
MCP設定ページから、追加のツールを設定できます。
| ツール | 説明 |
|---|---|
| リポジトリへの貢献 | 作成したリポジトリにファイルを作成して書き込みます |
| サンドボックス | Sandboxesの作成と使用: Sandboxファイル管理を含む |
| ジョブの実行と管理 | Hugging Face のインフラストラクチャ上でジョブを実行、監視、スケジュールします。 |
実験的なツールは随時追加されます。それらのツールが体験を向上させるかどうかを、こちらからフィードバックしてください。
コミュニティツール（Spaces）を追加
コミュニティが構築したMCP互換のGradio Spacesで、セットアップを拡張できます:
Gradio MCP アプリは、関数をツール（引数と説明付き）として公開するため、アシスタントが直接呼び出すことができます。追加した新しいツールを認識できるように、クライアントを再起動または更新してください。
SpacesをMCPサーバーとして利用するための専用ガイドを、こちらでご覧いただけます。
Spacesのオプション
MCP設定には、Spacesの動作をカスタマイズするための複数のオプションが用意されています。
| オプション | 説明 |
|---|---|
| 動的スペース | MCP Spacesをランタイムで動的に呼び出します。有効にすると、アシスタントは手動で追加することなく、MCP互換のSpacesをオンザフライで検出し、利用できます。 |
| 埋め込み画像の削除 | Gradio Spacesによって生成された埋め込み画像を削除します。MCPクライアントの画像サポートが限られている場合、またはテキストのみの応答を希望する場合に便利です。 |
詳細はこちら
- 設定とクライアントのセットアップ: https://huggingface.co/settings/mcp
- 変更履歴の発表: https://huggingface.co/changelog/hf-mcp-server
- Hugging Face MCP サーバー: https://huggingface.co/mcp
- Gradio Spacesで独自のMCPサーバーを構築する: https://www.gradio.app/guides/building-mcp-server-with-gradio