Skip to main content
Glama
Sign In
enesjakozh

mcp-hfspace

by evalstate
npmGitHub
TypeScript
MIT License
755
283
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

mcp-hfspace MCP 服务器🤗

在这里阅读介绍llmindset.co.uk/resources/mcp-hfspace/

只需最少的设置即可连接到Hugging Face Spaces - 只需添加您的空间即可！

默认情况下，它连接到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 ，然后将以下内容添加到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" ] }

要使用私人空间，请为您的 Hugging Face Token 提供--hf-token=hf_...参数或HF_TOKEN环境变量。

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

文件处理和 Claude 桌面模式

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

URL 也可以作为输入提供：内容会传递到空间。

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

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

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

图像生成比较

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

我们将使用merve/paligemma2-vqav2空间链接来查询图像。在本例中，我们指定工作目录中可用的文件名：我们不想将图像直接上传到 Claude 的上下文窗口。因此，我们可以提示 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 - 文本转语音（下载音频）

在Claude 桌面模式下，音频文件保存在 WORK_DIR 目录中，Claude 会收到创建通知。如果非桌面模式，则文件将以 base64 编码的资源形式返回给客户端（如果客户端支持嵌入式音频附件，则此功能非常有用）。

语音制作

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

在这里，我们使用hf-audio/whisper-large-v3-turbo来转录一些音频，并将其提供给 Claude。

音频转录

示例 5 - 图像到图像

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

Omniparser 和 Artifact

示例 6 - 聊天

在这个例子中，克劳德为 Qwen 设置了许多推理谜题，并提出后续问题以进行澄清。

Qwen推理测试

指定 API 端点

如果需要，您可以通过将 API 端点添加到空间名称来指定它。因此，与其传入Qwen/Qwen2.5-72B-Instruct不如使用Qwen/Qwen2.5-72B-Instruct/model_chat 。

克劳德桌面模式

可以使用选项 --desktop-mode=false 或环境变量 CLAUDE_DESKTOP_MODE=false 禁用此功能。在这种情况下，内容将作为嵌入式 Base64 编码资源返回。

推荐空间

一些推荐尝试的空间：

图像生成

  • Shuttleai/Shuttle-3.1-Aesthetic
  • black-forest-labs/FLUX.1-schnell
  • yanze/PuLID-FLUX
  • gokaygokay/Inspyrenet-Rembg（背景去除）
  • diyism/Datou1111-shou_xin -精美铅笔画

聊天

  • Qwen/Qwen2.5-72B-指令
  • prithivMLmods/Mistral-7B-Instruct-v0.3

文本转语音/音频生成

  • fantaxy/声音-AI-SFX
  • parler-tts/parler_tts

语音转文本

  • HF-Audio/Whisper-Large-V3-Turbo
  • （OpenAI 模型使用未命名的参数，因此不起作用）

文本转音乐

  • haoheliu/audioldm2-text2audio-text2music

视觉任务

  • 微软/OmniParser
  • merve/paligemma2-vqav2
  • merve/paligemma-doc
  • DawnC/PawMatchAI
  • DawnC/PawMatchAI/on_find_match_click - 用于交互式狗狗推荐

其他功能

提示

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

资源

返回 WORK_DIR 目录中的文件列表，为了方便起见，会以“使用文件...”的文本形式返回文件名称。如果您想向 Claude 的上下文中添加内容，请使用回形针图标；否则，请指定 MCP 服务器的文件名。Claude 不支持从上下文内部传输资源。

私人空间

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

使用 Claude Desktop

要与 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) ] } } }

已知问题和限制

mcp-hfspace

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

克劳德桌面

  • Claude Desktop 0.75 似乎无法响应 MCP 服务器的错误，而是超时了。对于持续存在的问题，请使用 MCP 检查器来更好地诊断问题所在。如果某些功能突然停止运行，可能是由于您的 HuggingFace ZeroGPU 配额已耗尽 - 请稍后重试，或设置您自己的空间进行托管。
  • Claude Desktop 似乎使用 60 秒的硬超时值，并且似乎不使用进度通知来管理用户体验或保持活动状态。如果您使用 ZeroGPU 空间，大型/繁重的作业可能会超时。不过，请检查 WORK_DIR 以获取结果；如果生成了结果，MCP 服务器仍然会捕获并保存结果。
  • Claude Desktops 对服务器状态、日志等的报告并不是很好 - 使用@modelcontextprotocol/inspector来帮助诊断问题。

HuggingFace 空间

  • 如果 ZeroGPU 配额或队列过长，请尝试复制空间。如果您的作业耗时少于 60 秒，通常可以更改app.py中的函数装饰器@spaces.GPU(duration=20) ，以在运行作业时请求较少的配额。
  • 传递 HF_TOKEN 将使 ZeroGPU 配额适用于您的 (Pro) HF 帐户
  • 如果您拥有私人空间和专用硬件，HF_TOKEN 将授予您直接访问权限 - 无需配额。如果您要执行任何类型的生产任务，我建议您这样做。

第三方 MCP 服务

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

直接从 Claude 使用 HuggingFace Spaces。使用开源图像生成、聊天、视觉任务等功能。支持图片、音频和文本的上传/下载。

  1. Gradio MCP 支持
    1. 安装
      1. 基本设置
    2. 文件处理和 Claude 桌面模式
      1. 示例 1 - 图像生成（下载图像/Claude Vision）
      2. 示例2-视觉模型（上传图片）
      3. 示例 3 - 文本转语音（下载音频）
      4. 示例 4 - 语音转文本（上传音频）
      5. 示例 5 - 图像到图像
      6. 示例 6 - 聊天
      7. 指定 API 端点
      8. 克劳德桌面模式
    3. 推荐空间
      1. 图像生成
      2. 聊天
      3. 文本转语音/音频生成
      4. 语音转文本
      5. 文本转音乐
      6. 视觉任务
    4. 其他功能
      1. 提示
      2. 资源
      3. 私人空间
      4. 使用 Claude Desktop
    5. 已知问题和限制
      1. mcp-hfspace
      2. 克劳德桌面
      3. HuggingFace 空间
    6. 第三方 MCP 服务

      Related MCP Servers

      • Dataset Viewer MCP Server

        privetin
        A
        security
        A
        license
        A
        quality
        Enables interaction with the Hugging Face Dataset Viewer API, allowing users to browse, search, filter, and analyze datasets hosted on the Hugging Face Hub.
        Last updated -
        8
        14
        Python
        MIT License
        • Apple

      • Game Asset Generator

        MubarakHAlketbi
        -
        security
        A
        license
        -
        quality
        An MCP server that generates 2D and 3D game assets from text prompts using AI models from Hugging Face Spaces, allowing developers to easily create game art through Claude Desktop or other MCP clients.
        Last updated -
        34
        JavaScript
        MIT License
        • Apple
        • Linux

      • Hugging Face MCP Server

        shreyaskarnik
        -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that provides Claude and other LLMs with read-only access to Hugging Face Hub APIs, enabling interaction with models, datasets, spaces, papers, and collections through natural language.
        Last updated -
        4
        Python
        MIT License
        • Apple

      • mcp-hfspace MCP Server

        xiyuefox
        -
        security
        A
        license
        -
        quality
        Connects Claude Desktop to Hugging Face Spaces with minimal setup, enabling capabilities like image generation, vision tasks, text-to-speech, and chat with AI models.
        Last updated -
        755
        MIT License
        • Apple

      View all related MCP servers

      Appeared in Searches

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/evalstate/mcp-hfspace'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server