DEPLOYMENT.md

🚀 A1D MCP Server - Deployment Guide

📋 Quick Deployment to Hugging Face Space

Method 1: Using the Push Script (Recommended)

1. Run the push script:

   ./push_to_space.sh
   

2. When prompted for credentials:

   • Username: aigchacker (your Hugging Face username)
   • Password: Your Hugging Face token (not your account password)

3. Get your Hugging Face token:

   • Go to: https://huggingface.co/settings/tokens
   • Click "New token"
   • Name: a1d-mcp-server
   • Type: Write
   • Click "Generate a token"
   • Copy the token

Method 2: Manual Git Push

# Ensure you're in the project directory
cd /path/to/a1d-mcp-server-hf

# Check git status
git status

# Push to Space
git push -u origin main

🔧 Post-Deployment Configuration

1. Set Environment Variables in Space

1. Go to your Space: https://huggingface.co/spaces/aigchacker/a1d-mcp-server
2. Click "Settings" tab
3. Scroll to "Variables and secrets"
4. Add environment variable:
   • Name: A1D_API_KEY
   • Value: Your A1D API key (get from https://a1d.ai/home/api)
   • Type: Secret (recommended)
5. Click "Add variable"
6. Space will automatically restart

2. Verify Deployment

1. Check Space status: Should show "Running"
2. Test web interface: Click "App" tab to test tools
3. Test MCP endpoint: https://aigchacker-a1d-mcp-server.hf.space/gradio_api/mcp/sse

🔗 MCP Client Configuration

For Claude Desktop (Header-based API Key)

Add to your Claude Desktop config:

{
  "mcpServers": {
    "a1d-hosted": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://aigchacker-a1d-mcp-server.hf.space/gradio_api/mcp/sse",
        "--header",
        "API_KEY:${MCP_API_KEY}"
      ],
      "env": {
        "MCP_API_KEY": "your_a1d_api_key_here"
      }
    }
  }
}

For Claude Desktop (Environment Variable)

{
  "mcpServers": {
    "a1d-hosted": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://aigchacker-a1d-mcp-server.hf.space/gradio_api/mcp/sse"
      ]
    }
  }
}

🔍 Troubleshooting

Push Issues

Problem: fatal: unable to access 'https://huggingface.co/spaces/...' Solution:

• Check your Hugging Face token
• Ensure you have write permissions to the Space
• Try clearing git credentials: git config --global --unset credential.helper

Problem: Authentication failed Solution:

• Use your Hugging Face username and token (not password)
• Generate a new token with write permissions

Space Issues

Problem: Space shows "Build Error" Solution:

• Check the logs in the Space
• Ensure all files are properly committed
• Verify requirements.txt is correct

Problem: "API key not found" error Solution:

• Set A1D_API_KEY environment variable in Space settings
• Restart the Space after adding the variable

MCP Client Issues

Problem: MCP client can't connect Solution:

• Verify the Space is running
• Check the MCP endpoint URL
• Ensure mcp-remote is installed: npm install -g mcp-remote

📱 Space URLs

• Space Home: https://huggingface.co/spaces/aigchacker/a1d-mcp-server
• Web Interface: https://aigchacker-a1d-mcp-server.hf.space
• MCP Endpoint: https://aigchacker-a1d-mcp-server.hf.space/gradio_api/mcp/sse

🎯 Next Steps

1. ✅ Deploy to Space
2. ✅ Set environment variables
3. ✅ Test web interface
4. ✅ Configure MCP client
5. ✅ Test with Claude Desktop
6. 🎉 Start using AI tools!

---

Need help? Check the main README.md or create an issue in the repository.