Hub 文档
Spaces 作为 MCP 服务器
加入 Hugging Face 社区
并获得增强的文档体验
开始使用
Spaces 作为 MCP 服务器
您可以将**任何带有可见 `MCP` 徽章的公共 Space 暴露为一个可调用的工具**，该工具将在任何 MCP 兼容客户端中可用，您可以添加任意数量的 Space，无需编写任何代码。
设置您的 MCP 客户端
在您的 Hub MCP 设置 中，选择您的 MCP 客户端（VSCode、Cursor、Claude Code 等），然后按照设置说明进行操作。
您需要一个具有 读取 权限的有效 Hugging Face 令牌才能使用 MCP 工具。如果您没有，在此处创建一个新的“读取”访问令牌。
将现有 Space 添加到您的 MCP 工具
- 浏览兼容的 Spaces，查找可通过 MCP 使用的 Space。您也可以在任何 Space 卡片上查找灰色 MCP 徽章。
- 点击徽章并选择 添加到 MCP 工具，然后在提示时确认。
- 该 Space 应列在您 MCP 服务器设置的 Space 工具部分。
从您的 MCP 客户端使用 Spaces
如果您的 MCP 客户端配置正确，您添加的 Spaces 将立即可用，无需进行任何更改（如果未显示，请重启客户端，它应该就会出现）。大多数 MCP 客户端会列出当前加载的工具，以便您可以确保 Space 可用。
对于 ZeroGPU Spaces，当调用工具时将使用您的配额，如果您的配额用尽，您可以订阅 PRO 以获得每天 25 分钟的配额（比免费用户多 8 倍）。例如，您的 PRO 账户允许您每天使用 FLUX.1-schnell 生成多达 600 张图像。
构建您自己的 MCP 兼容 Gradio Space
要创建您自己的支持 MCP 的 Space，您需要创建一个新的 Gradio Space，然后确保在代码中启用 MCP 支持。从Gradio Spaces 入门，并务必查看详细的 MCP 指南以获取更多详细信息。
首先，安装支持 MCP 的 Gradio
pip install "gradio[mcp]"然后使用清晰的类型提示和文档字符串创建您的应用程序
import gradio as gr
def letter_counter(word: str, letter: str) -> int:
"""Count occurrences of a letter in a word.
Args:
word: The word to search in
letter: The letter to count
Returns:
Number of times the letter appears in the word
"""
return word.lower().count(letter.lower())
demo = gr.Interface(fn=letter_counter,
inputs=["text", "text"],
outputs="number")
demo.launch(mcp_server=True) # exposes an MCP schema automatically将应用程序推送到 Gradio Space，它将自动收到 MCP 徽章。然后任何人都可以通过单击将其添加为工具。
将现有的 Gradio Space 转换为 MCP 服务器也非常简单。从上下文菜单中复制它，然后只需将
mcp_server=True 参数添加到您的 launch() 方法中，并确保您的函数具有清晰的类型提示和文档字符串 - 您可以非常轻松地使用 AI 工具自动化此过程（示例：AI 生成的文档字符串）。通过混合 Spaces 来发挥创意！
由于 Hugging Face Spaces 是最大的 AI 应用程序目录，您可以找到许多可作为 MCP 工具的创意工具。混合和匹配不同的 Spaces 可以带来强大而富有创意的工作流程。