Risad-Raihan/huggingface_mcp_server

Hugging Face MCP Server

A Model Context Protocol (MCP) server for seamless Hugging Face integration with Cursor and other MCP-compatible tools.

🎉 Successfully Installed!

Your Hugging Face MCP server is now installed and ready to use on your E: drive.

📁 Installation Location

E:\huggingface-mcp-server\

✅ What's Working

• ✅ MCP Server compiled and built successfully
• ✅ Basic tools available (search_models, get_model_info, check_model_compatibility, get_task_categories)
• ✅ Configuration with your Hugging Face token
• ✅ System specs configured for 16GB RAM and RTX 2050

🔧 Cursor Integration

To integrate with Cursor, add this to your Cursor settings:

Method 1: Through Cursor Settings UI

1. Open Cursor (Ctrl+, for settings)
2. Search for "MCP"
3. Add a new server with these details:
   • Name: huggingface
   • Command: node
   • Arguments: ["E:\\huggingface-mcp-server\\dist\\index.js"]
   • Working Directory: E:\huggingface-mcp-server

Method 2: Edit settings.json

Add this to your Cursor settings.json:

{
  "mcp": {
    "servers": {
      "huggingface": {
        "command": "node",
        "args": ["E:\\huggingface-mcp-server\\dist\\index.js"],
        "cwd": "E:\\huggingface-mcp-server"
      }
    }
  }
}

🚀 Quick Test

After adding to Cursor, restart Cursor and try asking:

• "What Hugging Face tools are available?"
• "Search for text generation models"
• "Check if microsoft/DialoGPT-small is compatible with my system"
• "Show me the available task categories"

📋 Available Tools

1. search_models - Search models with filters
2. get_model_info - Get detailed model information
3. check_model_compatibility - Check system compatibility
4. get_task_categories - List available model tasks

⚙️ Configuration

Your configuration is stored in:

• Environment variables: .env file
• Your Hugging Face token is already configured

🔧 Development Commands

# Navigate to your project
cd E:\huggingface-mcp-server

# Rebuild after changes
npm run build

# Test the server directly
npm run dev

# Install new dependencies
npm install

📝 Your System Specs

• RAM: 16GB
• GPU: RTX 2050
• Storage: E: drive (saving C: drive space ✅)
• Token: Configured and ready

🎯 Next Steps

1. Add to Cursor using the configuration above
2. Restart Cursor completely
3. Test the integration with the example queries
4. Enjoy browsing and managing Hugging Face models directly from Cursor!

🔍 Troubleshooting

If you encounter issues:

1. Server not responding: Check the path E:\huggingface-mcp-server\dist\index.js exists
2. Cursor can't find server: Verify Node.js is in your PATH: node --version
3. Need to rebuild: Run npm run build in the project directory
4. Check logs: Look at Cursor's developer console (F12)

🎉 Congratulations! Your Hugging Face MCP server is ready to use. You can now browse, search, and manage Hugging Face models directly from Cursor!