modelscope·@xiyuefox/mcp-hfspace
将 Claude Desktop 与 Hugging Face Spaces 连接起来,设置简单,能够实现图像生成、视觉任务、文本转语音和与 AI 模型聊天等功能。
在这里阅读介绍 llmindset.co.uk/resources/mcp-hfspace/
以最少的设置连接到 Hugging Face Spaces - 只需添加您的空间并开始使用!
默认情况下,它连接到 evalstate/FLUX.1-schnell,为 Claude Desktop 提供图像生成功能。

NPM 包是 @llmindset/mcp-hfspsace。
为您的平台安装最新版本的 NodeJS,然后将以下内容添加到 claude_desktop_config.json 文件的 mcpServers 部分:
"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 环境变量。
下面是一个使用现代图像生成器、视觉模型和文本转语音的配置示例,其中设置了工作目录:
"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 环境变量提供您的 Hugging Face Token。
如果需要,可以运行多个服务器实例以使用不同的工作目录和令牌。
默认情况下,服务器在 Claude Desktop 模式 下运行。在此模式下,工具响应中返回图像,而其他文件则保存在工作文件夹中,其文件路径作为消息返回。如果使用 Claude Desktop 作为客户端,这通常会带来最佳体验。
也可以提供 URL 作为输入:内容将传递给 Space。
有一个“可用资源”提示,它向 Claude 提供来自工作目录的可用文件和 MIME 类型。这是目前管理文件的最佳方式。
我们将使用 Claude 来比较由 shuttleai/shuttle-3.1-aesthetic 和 FLUX.1-schnell 创建的图像。这些图像被保存到工作目录中,并包含在 Claude 的上下文窗口中 - 因此 Claude 可以使用其视觉能力。

我们将使用 merve/paligemma2-vqav2 空间链接 来查询一张图片。在这种情况下,我们指定工作目录中可用的文件名:我们不想直接将图片上传到 Claude 的上下文窗口。因此,我们可以提示 Claude:
use paligemma to find out who is in "test_gemma.jpg" -> 文本输出: 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 -> 在图片中检测到一个人 - Taylor Swift 在舞台上。
在 Claude 桌面模式 下,音频文件保存在 WORK_DIR 中,并且 Claude 会收到创建通知。如果不在桌面模式下,则文件作为 base64 编码的资源返回给客户端(如果支持嵌入式音频附件则非常有用)。

这里,我们使用 hf-audio/whisper-large-v3-turbo 来转录音频,并使其对 Claude 可用。

在这个例子中,我们为 microsoft/OmniParser 指定文件名,得到一个带有注释的图像和两段单独的文字:描述和坐标。使用的提示是 use omniparser to analyse ./screenshot.png 和 use the analysis to produce an artifact that reproduces that screen。DawnC/Pawmatch 在这方面也表现得很好。

在这个例子中,Claude 为 Qwen 设置了一系列推理谜题,并提出后续问题以求澄清。

如果需要,您可以通过将其添加到空间名称来指定特定的 API 端点。因此,不是传递 Qwen/Qwen2.5-72B-Instruct,而是使用 Qwen/Qwen2.5-72B-Instruct/model_chat。
可以通过选项 --desktop-mode=false 或环境变量 CLAUDE_DESKTOP_MODE=false 来禁用此模式。在这种情况下,内容将以嵌入式 Base64 编码资源的形式返回。
一些推荐尝试的空间:
每个 Space 的提示词都会生成,并提供输入的机会。请注意,通常 Spaces 的配置并不特别具有帮助性的标签等。Claude 实际上非常擅长解决这些问题,工具描述也非常丰富(但在 Claude Desktop 中不可见)。
返回 WORK_DIR 中文件列表,并方便地将名称作为“使用该文件...”文本返回。如果你想在 Claude 的上下文中添加内容,请使用回形针图标 - 否则请为 MCP 服务器指定文件名。Claude 不支持从上下文内传输资源。
私人空间支持通过 HuggingFace 令牌使用。此令牌用于下载和保存生成的内容。
要与 Claude Desktop 一起使用,请添加服务器配置:
在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json
{
"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)
]
}
}
}
app.py 中的函数装饰器 @spaces.GPU(duration=20) 更改为在运行任务时请求较少的配额。X-IP-Token 头来实现这一点。<a href="https://glama.ai/mcp/servers/s57c80wvgq"><img width="380" height="200" src="https://glama.ai/mc…
ModelContextProtocol服务器适用于Magic UI,它通过提供诸如跑马灯、动画、特效和互动背景等组件的代码,使AI助手能够轻松为Web应用程序实现UI组件。
一个提供网页开发工具的MCP服务器,例如屏幕捕捉功能,可以让AI代理获取并处理用户屏幕的截图。
一个由人工智能驱动的工具,可以从自然语言描述生成现代UI组件,并与流行的IDE集成,以简化UI开发工作流程。
通过模型上下文协议(MCP)将Blender连接到Claude AI,使Claude能够直接与Blender交互并对其进行控制,从而实现AI辅助的3D建模、场景操作和渲染。
集成了Dify AI API,为Ant Design组件提供代码生成服务,支持文本和图像输入,并具备流式处理能力。
一种模型上下文协议服务器,提供创建、管理和导出Excalidraw绘图的API功能,支持SVG、PNG和JSON等多种格式。