A1d Image Video Mcp Tools

A1D MCP Server - 通用 AI 工具

功能强大的 MCP（模型上下文协议）服务，为所有兼容 MCP 的客户端提供 AI 图像和视频处理工具。开箱即用，无需任何设置。

🤖 可用的 AI 工具

工具	描述	使用场景
remove_bg	AI 背景移除	移除照片、产品图像中的背景
image_upscaler	AI 图像增强	将图像分辨率提升至 2x、4x、8x、16x
video_upscaler	AI 视频增强	提升视频质量和分辨率
image_vectorization	转换为矢量图	将图像转换为可缩放的 SVG 图形
image_extends	智能图像扩展	智能扩展图像边界
image_generator	文本生成图像 AI	根据文本描述生成图像

🚀 快速设置（2 分钟）

1. 获取 API 密钥

• 访问 A1D.ai 获取免费的 API 密钥
• 可选：购买额度以延长使用时间

2. 连接 MCP 客户端

适用于 Claude Desktop： 将以下内容添加到 Claude Desktop 配置文件：

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

适用于 MCP Inspector：

• 启动：npx @modelcontextprotocol/inspector
• 传输类型：SSE
• URL：https://mcp.a1d.ai/sse
• 添加请求头：api_key: your_api_key_here

适用于其他 MCP 客户端：

• 服务 URL：https://mcp.a1d.ai/sse
• 身份验证：请求头 api_key: your_api_key_here

3. 重启客户端

完成！你将在 MCP 客户端中看到可用的 AI 工具。

💡 使用方法

配置完成后，只需向 AI 助手提出图像或视频处理需求：

• “移除此图像的背景”
• “将此图像的分辨率提升至 4x”
• “将这张照片转换为矢量图”
• “生成一张山峦上空的日落图像”

🔧 配置帮助

Claude Desktop 配置文件位置

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

故障排除

工具没有显示？

• 添加配置后重启 MCP 客户端
• 确认 API 密钥正确
• 检查配置文件语法

连接问题？

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

如有需要，清除缓存：

rm -rf ~/.mcp-auth

📚 资源

• API 文档 - 详细的 API 参考
• 获取 API 密钥 - 免费注册
• 定价 - 额度套餐

🛠️ 面向开发者

想要添加更多工具或自定义服务？此代码仓库包含完整源代码，并采用配置驱动架构。

本地开发

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

本地服务将在 http://localhost:8787 上启动。你可以在请求中添加 api_key 请求头，使用自己的 API 密钥进行测试。

添加新工具

只需编辑 src/config/tools.json，即可添加新的 AI 工具，无需编写代码：

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

详细说明请参阅 docs/ADD_NEW_TOOL.md。

🔐 安全

• 用户提供的凭据：此服务要求用户通过请求头提供自己的 A1D API 密钥
• 不存储密钥：所有 API 密钥均通过请求头传递，不会存储在服务端
• 报告漏洞：负责任地披露漏洞，请参阅 SECURITY.md

🤝 参与贡献

欢迎贡献！请按以下步骤操作：

1. Fork 此代码仓库
2. 创建功能分支
3. 遵循现有代码风格
4. 为新功能添加测试
5. 提交拉取请求

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

---