⚙

Hugging Face MCP服务器

Hugging Face MCP服务器是一个提供多种AI模型服务的工具，支持图像生成、文本转语音、语音转文本、视觉任务等功能，适用于开发者和研究人员。

作者 By evalstate
本地部署 AI模型服务 图像生成
GitHub

mcp-hfspace mcp服务器🤗

[！提示]

您可以直接在以下网址访问和配置Hugging Face MCP服务https://hf.co/mcp包括Gradio空间。

这个项目已经被官方取代了 拥抱脸部MCP服务器 和 Gradio MCP终点.

或者，您可以在本地将hf-mcp服务器作为STDIO服务器运行，或者对SSE、流式HTTP和流式HTTP JSON模式提供强大的支持。这也运行了一个本地UI，用于选择工具和端点，并支持 ToolListChangedNotifications 我也是。

hf.co/mcp

mcp hfspace

在此处阅读介绍 llmindset.co.uk/resources/mcp-hfspace/

连接到 拥抱面部空间 只需进行最少的设置，只需添加您的空间即可！

默认情况下，它连接到 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 的 对于您的平台，然后将以下内容添加到 mcpServers 你的部分 claude_desktop_config.json 文件：

JSON``` 1 2 3 4 5 6 7 “mcp-hfspace”: { “command”: “npx”, “args”: [ “-y”, “@llmindset/mcp-hfspace” ] }


请确保您使用的是Claude Desktop 0.78或更高版本。


这将使您开始使用图像生成器。


### 基本设置


在参数中提供HuggingFace空格列表。mcp-hfspace将找到最合适的端点，并自动配置它以供使用。一个例子 `claude_desktop_config.json` 已供应 在…下面.


默认情况下，当前工作目录用于文件上传/下载。在Windows上，这是一个读/写文件夹，位于 `\users\<username>\AppData\Roaming\Claude\<version.number\`，在MacOS上，它是只读根： `/`.


建议覆盖此设置，并设置一个工作目录来处理图像和其他基于文件的内容的上传和下载。指定以下任一项 `--work-dir=/your_directory` 争论或 `MCP_HF_WORK_DIR` 环境变量。


使用现代图像生成器、视觉模型和文本到语音的示例配置，以及工作目录集如下：


JSON```
1
2
3
4
5
6
7
8
9
10
11    "mcp-hfspace": {
      "command": "npx",
      "args": [
        "-y",
        "@llmindset/mcp-hfspace",
        "--work-dir=/Users/evalstate/mcp-store",
        "shuttleai/shuttle-jaguar",
        "styletts2/styletts2",
        "Qwen/QVQ-72B-preview"
      ]
    }

要使用私人空间，请提供您的拥抱脸令牌 --hf-token=hf_... 争论或 HF_TOKEN 环境变量。

如果需要，可以运行多个服务器实例来使用不同的工作目录和令牌。

文件处理和Claude桌面模式

默认情况下，服务器在 _克劳德桌面模式_在此模式下，图像将在工具响应中返回，而其他文件则保存在工作文件夹中，其文件路径将作为消息返回。如果使用Claude Desktop作为客户端，这通常会提供最佳体验。

URL也可以作为输入提供：内容被传递到Space。

有一个“可用资源”提示，为Claude提供工作目录中的可用文件和mime类型。这是目前管理文件的最佳方式。

示例1-图像生成（下载图像/Claude Vision）

我们将使用Claude来比较由创建的图像 shuttleai/shuttle-3.1-aesthetic 和 FLUX.1-schnell。图像会保存到工作目录中，并包含在克劳德的上下文窗口中，这样克劳德就可以使用它的视觉功能。

示例2-视觉模型（上传图像）

我们将使用 merve/paligemma2-vqav2 空间链路 查询图像。在这种情况下，我们指定工作目录中可用的文件名：我们不想直接将图像上传到Claude的上下文窗口。所以，我们可以提示克劳德：

use paligemma to find out who is in "test_gemma.jpg" -> Text Output: david bowie

如果您要将内容上传到Claude的上下文中，请使用回形针附件按钮，否则请指定服务器直接发送的文件名。

我们还可以提供一个URL。例如： use paligemma to detect humans in https://e3.365dm.com/24/12/1600x900/skynews-taylor-swift-eras-tour_6771083.jpg?20241209000914 -> One person is detected in the image - Taylor Swift on stage.

示例3-文本转语音（下载音频）

在……里面 克劳德桌面模式，音频文件保存在WORK_DIR中，克劳德会收到创建通知。如果不是在桌面模式下，文件将作为base64编码的资源返回给客户端（如果它支持嵌入式音频附件，则很有用）。

示例4-语音转文本（上传音频）

在这里，我们使用 hf-audio/whisper-large-v3-turbo 转录一些音频，并提供给克劳德。

示例5-图像到图像

在这个例子中，我们为指定文件名 microsoft/OmniParser 使用，并返回一个带注释的图像和两个单独的文本：描述和坐标。使用的提示是 use omniparser to analyse ./screenshot.png 和 use the analysis to produce an artifact that reproduces that screen. DawnC/Pawmatch 他也很擅长这个。

示例6-聊天

在这个例子中，克劳德为Qwen设置了一些推理谜题，并要求后续问题进行澄清。

指定API终结点

如果需要，可以通过将特定的API端点添加到空间名称中来指定该端点。所以，与其路过 Qwen/Qwen2.5-72B-Instruct 你会使用 Qwen/Qwen2.5-72B-Instruct/model_chat.

克劳德桌面模式

这可以通过选项–desktop mode=false或环境变量CLAUDE_desktop_mode=false禁用。在这种情况下，内容作为嵌入式Base64编码资源返回。

推荐空间

一些推荐的空间可以尝试：

图像生成

  • 毽子/3.1-美学
  • 黑森林实验室/FLUX.1-schnell
  • 晏泽/普丽德FLUX
  • gokaygokay/Inspyrenet Rembg（背景移除）
  • DIY/大头1111-shouxin- 美丽的铅笔画

聊天

  • Qwen/Qwen2.5-72B-说明书
  • 价格MLmods/Mistral-7B-Instruct-v0.3

文本转语音/音频生成

  • fantaxy/Sound AI SFX
  • 经销商tts/parler_tts

语音输入

  • 高频音频/扬声器-arge-v3-turbo
  • （openai模型使用未命名的参数，因此无法工作）

文本转音乐

  • haoheliu/audioldm2-text2音频-text2音乐

愿景任务

  • 微软/OmniParser
  • merve/palegemma2-vqav2
  • merve/palegema文件
  • DawnC/PowMatchAI
  • DawnC/PawMatchAI/on_find_match_click-用于交互式狗推荐

其他特征

提示

每个空格都会生成提示，并提供输入机会。请记住，空间通常没有配置特别有用的标签等。Claude实际上非常擅长解决这个问题，工具描述非常丰富（但在Claude Desktop中不可见）。

资源

返回WORK_DIR中的文件列表，为方便起见，将名称返回为“使用文件…”文本。如果你想在Claude的上下文中添加一些东西，请使用回形针，否则请指定MCP服务器的文件名。Claude不支持从Context中传输资源。

私人空间

私人空间支持HuggingFace令牌。令牌用于下载和保存生成的内容。

使用克劳德桌面

要与Claude Desktop一起使用，请添加服务器配置：

在MacOS上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

JSON``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17{ “mcpServers”: { “mcp-hfspace”: { “command”: “npx” “args”: [ “-y”, “@llmindset/mcp-hfspace”, “—work-dir=~/mcp-files/ or x:/temp/mcp-files/”, “—HF_TOKEN=HF_{optional token}” “Qwen/Qwen2-72B-Instruct”, “black-forest-labs/FLUX.1-schnell”, “space/example/specific-endpint” (… and so on) ] } } }


## 已知问题和限制


### mcp hfspace


- 目前不支持具有未命名参数的端点。
- 从一些复杂的Python类型到合适的MCP格式的完整翻译。


### 克劳德桌面


- Claude Desktop 0.75似乎对MCP服务器的错误没有响应，而是超时。对于持续存在的问题，使用MCP检查器可以更好地诊断出问题所在。如果某个东西突然停止工作，这可能是由于您的HuggingFace ZeroGPU配额耗尽——请在短时间后重试，或设置自己的空间进行托管。
- Claude Desktop似乎使用了60秒的硬超时值，并且似乎没有使用进度通知来管理用户体验或保持活动。如果您使用的是ZeroGPU空间，则大型/重型作业可能会超时。不过，请检查WORK_DIR的结果；如果产生结果，MCP服务器仍将捕获并保存结果。
- Claude桌面报告服务器状态、日志记录等不是很有用 [@模型上下文协议/检查器](https://github.com/modelcontextprotocol/inspector) 以帮助诊断问题。


### 拥抱面部空间


- 如果ZeroGPU配额或队列太长，请尝试复制空间。如果你的工作时间不到60秒，你通常可以更改函数装饰器 `@spaces.GPU(duration=20)` 在……里面 `app.py` 在运行作业时请求较少的配额。
- 通过HF_TOKEN将使ZeroGPU配额适用于您的（专业版）HF帐户
- 如果你有一个私人空间和专用硬件，你的HF_TOKEN将让你直接访问它——没有配额。如果您正在使用任何类型的生产任务，我建议您这样做。


## 第三方MCP服务


[![mcp-hfspace MCP server](https://glama.ai/mcp/servers/s57c80wvgq/badge)](https://glama.ai/mcp/servers/s57c80wvgq)