mcp-registry/mcp-hfspace

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-hfspace

by evalstate

Node-based MCP Server that lets you expose one or more Hugging Face Spaces as Model Context Protocol (MCP) endpoints, with special integration for Claude Desktop (file handling, desktop-mode, tool discovery, etc.).

330
48
Open Source
GitHubWebsiteDocumentationNPM

Installation

1. Prerequisites
• Node.js ≥ 18 and npm (or pnpm/yarn)
• A HuggingFace access-token with “inference” scope
• (Optional) Claude API key if you intend to use Claude-Desktop mode
2. Clone the repository
git clone https://github.com/evalstate/mcp-hfspace.git cd mcp-hfspace
3. Install dependencies
npm install # or pnpm install | yarn
4. Build the TypeScript sources
npm run build # emits JS to ./dist
5. Configure environment
Create a .env file or export variables in your shell: HF_TOKEN="<your_huggingface_token>" CLAUDE_TOKEN="<your_claude_key>" # optional PORT=3333 # default port the MCP server listens on
6. Start the server
npm start # or: node dist/index.js
7. Verify
Open http://localhost:3333/health to check the health probe. Docker (alternative): docker build -t mcp-hfspace . docker run -e HF_TOKEN=xxxxx -p 3333:3333 mcp-hfspace

Documentation

License: MIT License
Updated 7/15/2025
mcp-hfspace - MCP Server Registry - Augment Code