mcp-mavae
3.1
If you are the rightful owner of mcp-mavae and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
MAVAE is a Model Context Protocol (MCP) server for interacting with image media tools. It provides a standardized interface for AI Agents to generate and manipulate images.
MAVAE - IMAGE TOOLBOX
A powerful creative and editing toolkit designed for AI Agents.
MAVAE is a Model Context Protocol (MCP) server for interacting with image media tools. It provides a standardized interface for AI Agents to generate and manipulate images.
๐ Features
- Image Generation: Generate images using both raw configurations and predefined collections
- Image Editing: Compress, crop, and resize images with proportional or fixed dimensions
- Collection Management: Create, manage, and share configurations for consistent image generation
- Model & Lora Management: List and utilize available models and Loras
- API Token Management: Handle authentication for secure interaction with Mavae services
๐ Prerequisites
- Node.js (v16 or higher)
- MAVAE API Key (set as environment variable, Apply here)
๐ ๏ธ Installation
# Install dependencies
npm install
# Build the project
npm run build
# Start the server
npm start
MCP Json
{
"mcpServers": {
"mavae": {
"command": "node",
"args": [
"***/dist/index.js"
],
"env": {
"MAVAE_API_KEY": MAVAE_API_KEY
}
}
}
}
When using MAVAE MCP locally, this path is an absolute path ๐๐ป "***/dist/index.js"
๐ณ Docker Support
# Build Docker image
docker build -t mavae-mcp-server .
# Run Docker container
docker run -e MAVAE_API_KEY=your_api_key mavae-mcp-server
๐ Project Structure
mavae/
โโโ src/ # Source code
โ โโโ actions/ # API endpoint implementation handlers
โ โ โโโ aigc.ts # Image generation operations
โ โ โโโ collection.ts # Collection management operations
โ โ โโโ edit.ts # Image editing operations
โ โ โโโ token.ts # API token operations
โ โโโ tools/ # MCP tool definitions
โ โ โโโ aigc.ts # Image generation tool definitions
โ โ โโโ collection.ts # Collection management tool definitions
โ โ โโโ edit.ts # Image editing tool definitions
โ โโโ types/ # TypeScript type definitions
โ โ โโโ aigc.ts # Image generation types
โ โ โโโ collection.ts # Collection types
โ โ โโโ edit.ts # Image editing types
โ โ โโโ response.ts # API response types
โ โโโ utils/ # Utility functions
โ โ โโโ constants.ts # Constant values
โ โโโ index.ts # Server entry point
โโโ dist/ # Compiled JavaScript files
โโโ package.json # Project dependencies and scripts
โโโ tsconfig.json # TypeScript configuration
๐๏ธ Available Tools
Image Generation
image_raw_generate- Generate an image using raw AIGC configurationimage_collection_generate- Generate an image using a collection's AIGC configurationimage_retry_generate- Retry a failed image generationimage_state- Get the details of an owned imagegenerate_task_state- Get the generation state of an image by task id
Collection Management
collection_create- Create a new collectioncollection_delete- Delete a collectioncollection_toggle_public- Toggle the public status of a collectioncollection_list- Get the list of owned collectionscollection_state- Get the details of an owned collection
Image Editing
compress_image- Lossless compression of imagescrop_image- Crop images with local path and URL supportresize_image- Resize images with proportional or fixed dimensions
Model & Resources
list_images- Get the list of owned imageslist_loras- Get the list of available loraslist_models- Get the list of available models
Authentication
token_state- Get the x-api-token state
