modelscope·@evalstate/mcp-hfspace
直接从 Claude 使用 HuggingFace Spaces。支持开源图像生成、聊天、视觉任务等。支持图像、音频和文本的上传/下载。
在此阅读介绍 llmindset.co.uk/resources/mcp-hfspace/
只需添加你的空间即可连接到 Hugging Face Spaces！
默认情况下，它会连接到 evalstate/FLUX.1-schnell，为 Claude 桌面版提供图像生成能力。
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 令牌。
如果需要，可以运行多个服务器实例以使用不同的工作目录和令牌。
默认情况下，服务器在 Claude 桌面模式 下运行。在这种模式下，工具响应中返回图像，而其他文件保存在工作文件夹中，其文件路径作为消息返回。如果您使用 Claude 桌面作为客户端，这通常会提供最佳体验。
也可以提供 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 桌面版中不可见）。
返回 WORK_DIR 中文件列表，并方便地以“使用该文件...”文本形式显示文件名。如果你想将某些内容添加到 Claude 的上下文中，请使用回形针图标 - 否则请为 MCP 服务器指定文件名。Claude 不支持从上下文内传输资源。
通过 HuggingFace token 支持私有 Space。Token 用于下载和保存生成的内容。
要与 Claude 桌面版一起使用，请添加服务器配置：
在 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) 以请求运行任务时较少的配额。当然，以下是翻译后的中文内容，保持了原有的 markdown 格式，并保留了所有的代码块和链接内容：
<a href="https://glama.ai/mcp/servers/s57c80wvgq"><img width="380" height="200" src="https://glama.ai/mcp/servers/s57c80wvgq/badge" alt="mcp-hfspace MCP 服务器" /></…
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等多种格式。