MCP Hfspace

🚀 MCP Protocol Server: User Guide

The MCP (Model Context Protocol) is a protocol designed to connect and manage various AI models. It supports multiple tasks such as text generation, image processing, and speech recognition. With this protocol, users can conveniently configure multiple AI models and invoke them to complete specific tasks when needed.

🚀 Quick Start

✨ Features

• Connect and manage various AI models.
• Support multiple tasks including text generation, image processing, and speech recognition.
• Convenient configuration and invocation of AI models.

📦 Installation

Install the MCP Protocol Server

Use the npm command to install:

npm install -y @llmindset/mcp-hfspace

Start the Server

Start the MCP protocol server and specify the working directory and Hugging Face token (optional):

npx @llmindset/mcp-hfspace --work-dir=/path/to/work/directory --HF_TOKEN=your_hf_token_here model1_id model2_id specific_endpoint

💻 Usage Examples

Configuration Example

Add the MCP server configuration to the Claude desktop application: MacOS Path: ~/Library/Application Support/Claude/claude_desktop_config.json Windows Path: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-hfspace": {
      "command": "npx",
      "args": [
        "-y",
        "@llmindset/mcp-hfspace",
        "--work-dir=~/mcp-files/",
        "--HF_TOKEN=HF_{your_token_here}",
        "Qwen/Qwen2-72B-Instruct",
        "black-forest-labs/FLUX.1-schnell",
        "space/example/specific-endpoint"
      ]
    }
  }
}

📚 Documentation

Known Issues and Limitations

MCP Protocol Server

• Currently, endpoints with unnamed parameters are not supported.
• The function of converting complex Python types to MCP format is still under development.

Claude Desktop Application

• Version 0.75 has a response timeout issue. It is recommended to use the MCP Inspector tool for diagnosis.
• When using the ZeroGPU space, long-running tasks are prone to timeout. It is recommended to set a shorter GPU quota time (e.g., 20 seconds) to avoid timeouts.

Third - Party MCP Services