README.md•4.65 kB
# 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
| 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 (2 minutes)
### 1. Get Your API Key
- Visit [A1D.ai](https://a1d.ai/home/api) to get your free API key
- Optional: [Purchase credits](https://a1d.ai/pricing) for extended usage
### 2. Connect Your MCP Client
**For Claude Desktop:**
Add this to your Claude Desktop configuration file:
```json
{
"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?**
```bash
# Test the connection directly
npx mcp-remote https://mcp.a1d.ai/sse --header "api_key:your_api_key"
```
**Clear cache if needed:**
```bash
rm -rf ~/.mcp-auth
```
## 📚 Resources
- **[API Documentation](https://a1d.ai/api/quick-start)** - Detailed API reference
- **[Get API Key](https://a1d.ai/home/api)** - Free registration
- **[Pricing](https://a1d.ai/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
```bash
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:
```json
{
"name": "new_tool",
"description": "Tool description",
"apiEndpoint": "/api/endpoint",
"inputSchema": { /* ... */ },
"zodValidation": { /* ... */ }
}
```
See [docs/ADD_NEW_TOOL.md](docs/ADD_NEW_TOOL.md) 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 [SECURITY.md](SECURITY.md) 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 [LICENSE](LICENSE) file for details.
---
<div align="center">
<strong>Built with ❤️ by the A1D Team</strong><br>
<a href="https://a1d.ai">A1D.ai</a> •
<a href="https://github.com/AIGC-Hackers/a1d-mcp-server">GitHub</a> •
<a href="https://a1d.ai/api/quick-start">API Docs</a>
</div>