mcp-hfspace MCP Server 🤗

基本能力

产品定位

mcp-hfspace 是一个 MCP 服务器，用于连接 Hugging Face Spaces，提供多种 AI 模型和服务，包括图像生成、文本转语音、语音转文本、视觉模型等。

核心功能

1. 图像生成：支持多种图像生成模型，如 shuttleai/shuttle-3.1-aesthetic 和 FLUX.1-schnell。
2. 文本转语音：支持文本转语音模型，如 parler-tts/parler_tts。
3. 语音转文本：支持语音转文本模型，如 hf-audio/whisper-large-v3-turbo。
4. 视觉模型：支持多种视觉模型，如 microsoft/OmniParser 和 merve/paligemma2-vqav2。
5. 聊天模型：支持聊天模型，如 Qwen/Qwen2.5-72B-Instruct。
6. 文件处理：支持文件上传和下载，支持指定工作目录。
7. 私有空间支持：支持通过 Hugging Face Token 访问私有空间。

适用场景

1. 图像生成：用于生成和比较不同模型生成的图像。
2. 文本转语音：用于将文本转换为语音文件。
3. 语音转文本：用于将语音文件转换为文本。
4. 视觉模型：用于图像分析和识别。
5. 聊天模型：用于与 AI 模型进行对话和推理。
6. 文件处理：用于管理上传和下载的文件。

工具列表

1. 图像生成工具：如 shuttleai/shuttle-3.1-aesthetic 和 FLUX.1-schnell。
2. 文本转语音工具：如 parler-tts/parler_tts。
3. 语音转文本工具：如 hf-audio/whisper-large-v3-turbo。
4. 视觉模型工具：如 microsoft/OmniParser 和 merve/paligemma2-vqav2。
5. 聊天模型工具：如 Qwen/Qwen2.5-72B-Instruct。

常见问题解答

1. 不支持端点：端点中未命名的参数暂时不支持。
2. Claude Desktop 问题：Claude Desktop 0.75 可能无法响应 MCP 服务器的错误，建议使用 MCP Inspector 进行诊断。
3. Hugging Face Spaces 问题：如果 ZeroGPU 配额或队列过长，可以尝试复制空间或调整函数装饰器。

使用教程

使用依赖

1. 安装最新版本的 NodeJS。

安装教程

1. 在 claude_desktop_config.json 文件的 mcpServers 部分添加以下配置：

    "mcp-hfspace": {
      "command": "npx",
      "args": [
        "-y",
        "@llmindset/mcp-hfspace"
      ]
    }

1. 确保使用 Claude Desktop 0.78 或更高版本。

调试方式

1. 使用 --work-dir=/your_directory 参数或 MCP_HF_WORK_DIR 环境变量指定工作目录。
2. 使用 --hf-token=hf_... 参数或 HF_TOKEN 环境变量指定 Hugging Face Token。
3. 使用 --desktop-mode=false 或 CLAUDE_DESKTOP_MODE=false 禁用 Claude Desktop 模式。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。