README.md

metadata

title: A1d Mcp Server
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
license: mit
tags:
  - mcp-server-track

A1D MCP Server - Universal AI Tools

A powerful MCP (Model Context Protocol) server built with Gradio that provides AI image and video processing tools for any MCP-compatible client. This server implements the same tools as the original A1D MCP Server but uses Gradio for easy deployment and hosting.

🎥 Demo

MCP Server in Action: View Demo Recording

The demo shows the A1D MCP Server working with Claude Desktop and other MCP clients, featuring real-time AI image processing, seamless integration, and live preview of results.

🤖 Available AI Tools

Tool	Description	Use Cases
remove_bg	AI background removal	Remove backgrounds from photos, product images
image_upscaler	AI image enhancement	Upscale images 2x, 4x, 8x, 16x resolution
video_upscaler	AI video enhancement	Improve video quality and resolution
image_vectorization	Convert to vectors	Turn images into scalable SVG graphics
image_extends	Smart image extension	Expand image boundaries intelligently
image_generator	Text-to-image AI	Generate images from text descriptions

🚀 Quick Setup

1. Get Your API Key

• Visit A1D.ai to get your free API key
• Optional: Purchase credits for extended usage

2. Set Environment Variable

export A1D_API_KEY=your_api_key_here

3. Install Dependencies

pip install -r requirements.txt

4. Run the Server

Option 1: Using the startup script (Recommended)

python start_server.py

Option 2: Direct execution

python app.py

Option 3: Using virtual environment

source venv/bin/activate  # On Windows: venv\Scripts\activate
python start_server.py

The server will start on http://localhost:7860 with MCP server enabled.

5. Test the Installation

python test_app.py

This will run a comprehensive test suite to verify everything is working correctly.

🔧 MCP Server Features

This Gradio app serves as both a web interface and a full MCP server, providing:

✅ Dual Interface Support

• Web UI: Interactive Gradio interface at http://localhost:7860
• MCP Server: Protocol-compliant server at http://localhost:7860/gradio_api/mcp/sse

✅ Real-time Processing

• Async Task Handling: Uses SSE for real-time status updates
• Live Preview: Immediate media preview in both web and MCP clients
• Progress Tracking: Detailed logs of API calls and processing status

✅ Production Ready

• Error Handling: Comprehensive error management and user feedback
• API Integration: Direct integration with A1D.ai services
• Scalable: Can handle multiple concurrent requests

🔧 MCP Client Configuration

⚠️ API Key Required for Client Usage

When using with your own MCP client (Claude Desktop, Cursor, etc.), you must provide your API key:

{
  "mcpServers": {
    "a1d": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "http://localhost:7860/gradio_api/mcp/sse",
        "--header",
        "API_KEY:${MCP_API_KEY}"
      ],
      "env": {
        "MCP_API_KEY": "your_a1d_api_key_here"
      }
    }
  }
}

🔑 API key is mandatory for client usage. Get your API key at A1D.ai.

For Other MCP Clients

• Server URL: http://localhost:7860/gradio_api/mcp/sse
• Transport Type: SSE (Server-Sent Events)
• Protocol: MCP 1.0 compatible
• Authentication: API key via API_KEY header or environment variable

Configuration File Locations

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

🌐 Hosted Version

This server is also available as a hosted Hugging Face Space:

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

🔧 Environment Variables for Hugging Face Space

To deploy this on your own Hugging Face Space:

1. Fork or duplicate this Space
2. Go to Settings → Variables and secrets
3. Add the following environment variable:
   • Name: A1D_API_KEY
   • Value: Your A1D API key from A1D.ai
   • Type: Secret (recommended for security)
4. Save and restart the Space

🔗 MCP Client Configuration for Hosted Version

⚠️ API Key Required for Client Usage

When using with your own MCP client (Claude Desktop, Cursor, etc.), you must provide your API key:

{
  "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"
      }
    }
  }
}

🔑 API key is mandatory for client usage. Get your API key at A1D.ai.

🌐 Using the Hosted Demo on Hugging Face Space

The hosted demo at https://huggingface.co/spaces/aigchacker/a1d-mcp-server uses our provided API key for demonstration purposes only, with limited usage. For production use, please obtain your own API key.

💡 How to Use

Once configured, simply ask your AI assistant to help with image or video tasks:

• "Remove the background from this image: https://example.com/photo.jpg"
• "Upscale this image to 4x resolution: https://example.com/image.png"
• "Convert this photo to a vector graphic: https://example.com/logo.jpg"
• "Generate an image of a sunset over mountains"

🛠️ Development

Local Development

git clone https://github.com/your-repo/a1d-mcp-server-hf.git
cd a1d-mcp-server-hf
pip install -r requirements.txt
export A1D_API_KEY=your_api_key_here
python app.py

Project Structure

a1d-mcp-server-hf/
├── app.py              # Main Gradio application
├── config.py           # Configuration settings
├── utils.py            # Utility functions and API client
├── mcp_handler.py      # MCP request handler with header-based API keys
├── start_server.py     # Server startup script
├── test_app.py         # Test suite
├── requirements.txt    # Python dependencies
├── .env.example        # Environment variables example
├── .gitignore          # Git ignore file
├── LICENSE             # MIT license
└── README.md          # This file

🔐 Security

• User-provided credentials: This server supports multiple API key methods:
  • Header-based: API keys passed via MCP client headers (recommended)
  • Environment variables: Server-side API key configuration
• No stored secrets: All API keys are handled per-request, nothing is stored server-side
• Multi-user support: Each user can use their own API key via headers
• HTTPS recommended: Use HTTPS in production environments

🤝 Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Follow the existing code style
4. Add tests for new features
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Related Projects

• Original MCP Server: AIGC-Hackers/mcp-server
• A1D API Documentation: A1D.ai API Docs
• Gradio MCP Guide: Building MCP Server with Gradio

---

Built with ❤️ by the A1D Team A1D.ai • GitHub • API Docs