AIGC-Hackers/mcp-server

A1D MCP Server - Universal AI Tools

A powerful MCP (Model Context Protocol) server that provides AI image and video processing tools for any MCP-compatible client. Ready to use with zero setup required.

🤖 Available AI Tools

🚀 Quick Setup (2 minutes)

1. Get Your API Key

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

2. Connect Your MCP Client

For Claude Desktop: Add this to your Claude Desktop configuration file:

{
  "mcpServers": {
    "a1d": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.a1d.ai/sse",
        "--header",
        "api_key:${MCP_API_KEY}"
      ],
      "env": {
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

For MCP Inspector:

• Start: npx @modelcontextprotocol/inspector
• Transport Type: SSE
• URL: https://mcp.a1d.ai/sse
• Add header: api_key: your_api_key_here

For other MCP clients:

• Server URL: https://mcp.a1d.ai/sse
• Authentication: Header api_key: your_api_key_here

3. Restart Your Client

That's it! You'll see the AI tools available in your MCP client.

💡 How to Use

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

• "Remove the background from this image"
• "Upscale this image to 4x resolution"
• "Convert this photo to a vector graphic"
• "Generate an image of a sunset over mountains"

🔧 Configuration Help

Claude Desktop 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

Troubleshooting

Tools not showing up?

• Restart your MCP client after adding configuration
• Verify your API key is correct
• Check the configuration file syntax

Connection issues?

# Test the connection directly
npx mcp-remote https://mcp.a1d.ai/sse --header "api_key:your_api_key"

Clear cache if needed:

rm -rf ~/.mcp-auth

📚 Resources

• API Documentation - Detailed API reference
• Get API Key - Free registration
• Pricing - Credit packages

🛠️ For Developers

Want to add more tools or customize the server? This repository contains the complete source code with a configuration-driven architecture.

Local Development

git clone https://github.com/AIGC-Hackers/a1d-mcp-server.git
cd a1d-mcp-server
npm install
npm run start

The local server will start on http://localhost:8787. You can test it with your API key by adding the api_key header to requests.

Adding New Tools

Simply edit src/config/tools.json to add new AI tools without writing code:

{
  "name": "new_tool",
  "description": "Tool description",
  "apiEndpoint": "/api/endpoint",
  "inputSchema": { /* ... */ },
  "zodValidation": { /* ... */ }
}

See for detailed instructions.

🔐 Security

• User-provided credentials: This server expects users to provide their own A1D API keys via headers
• No stored secrets: All API keys are passed through request headers, nothing is stored server-side
• Report vulnerabilities: See for responsible disclosure

🤝 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 file for details.