Aipic Mcp
@leonaries
A Model Context Protocol (MCP) server that provides AI-powered image generation capabilities specifically designed for web design workflows. This server integrates with Alibaba Cloud DashScope's FLUX model to generate high-quality images based on English prompts, perfect for crea
Overview
What is Aipic Mcp?
Aipic Mcp is a Model Context Protocol server that provides AI-powered image generation using Alibaba Cloud DashScope’s FLUX model. It is designed for web design workflows, producing web-optimized images from English prompts. The server returns images in base64 format and can automatically save them to the user’s Desktop or a temporary directory.
How to use Aipic Mcp?
Install and run via npx (npx -y aipic-mcp) or globally (npm install -g aipic-mcp). Configure the server in Claude Desktop by adding the appropriate JSON block to the configuration file, specifying the DashScope API key either as an environment variable (DASHSCOPE_API_KEY) or when calling the tool. The main tool is generate_web_image, which accepts parameters prompt, apiKey (optional), width, height, and outputPath.
Key features of Aipic Mcp
- AI image generation using DashScope FLUX model
- Web-optimized output with proper compression and sizing
- Support for custom width and height (default 1024x1024)
- Returns images in base64 format for direct web use
- Smart file saving: auto-saves to Desktop, falls back to temp directory
- Async processing with reliable task polling and error handling
Use cases of Aipic Mcp
- Generating placeholder images or hero images for website designs
- Creating product mockups and e-commerce photos from prompts
- Producing abstract backgrounds or landscape images for web assets
- Rapidly prototyping visual elements during web development iterations
FAQ from Aipic Mcp
What API key do I need?
You need a DashScope API key from Alibaba Cloud with image generation permissions, typically starting with sk-. Provide it via the DASHSCOPE_API_KEY environment variable or the apiKey parameter when using the tool.
Where are generated images saved?
Images are automatically saved to your Desktop if possible; otherwise they fall back to the system’s temporary directory. You can also specify a custom path using the outputPath parameter.
How do I install Aipic Mcp?
The recommended method is npx -y aipic-mcp. Alternatively, install globally with npm install -g aipic-mcp. For local development, clone the GitHub repository and run npm run build.
Which AI model does it use?
The server uses the flux-schnell model from Alibaba Cloud DashScope, optimized for fast image generation. The endpoint is https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis.
What are the runtime dependencies?
Node.js 18+ is required. Key npm dependencies include @modelcontextprotocol/sdk, axios, sharp, and uuid. The server can be used with Claude Desktop or any MCP-compatible client.