Mavae Image Toolbox

🚀 MAVAE - Image Toolkit

A powerful creative generation and editing toolkit designed specifically for AI agents.

MAVAE is a Model Context Protocol (MCP) server for interacting with image media tools. It provides a standard interface for AI agents to generate and manipulate images.

🚀 Quick Start

Prerequisites

• Node.js (v16 or higher)
• MAVAE API key (set as an 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 the Docker image
docker build -t mavae-mcp-server .

# Run the Docker container
docker run -e MAVAE_API_KEY=your_api_key mavae-mcp-server

✨ Features

• Image Generation: Generate images using either original configurations or predefined collections.
• Image Editing: Compress, crop, and resize images, supporting proportional or fixed dimensions.
• Collection Management: Create, manage, and share configurations to ensure consistent image generation.
• Model and LoRA Management: List and use available models and LoRAs.
• API Token Management: Handle authentication to interact securely with Mavae services.

📚 Documentation

Project Structure

mavae/
├── src/                  # Source code
│   ├── mavae.ts        # Core functionality implementation
│   └── index.ts       # Entry file
└── dist/               # Build output directory
    └── main.js         # Packaged main program

Functional Modules

Image Generation

• generateImage: Generate high-quality images using AI models.
• editImage: Perform advanced editing operations on existing images.
• saveImage: Save processed images to a specified path.

Image Management

• getImageList: Get a list of all processed images.
• deleteImage: Delete a specified image file.
• exportImage: Export images in multiple formats (PNG, JPG, WEBP).

Model and Resource Management

• listModels: List available AI models.
• loadModel: Load a specific model for processing.
• updateModel: Update model configurations or parameters.

Security and Authentication

• authenticateToken: Verify the status of API tokens.
• refreshToken: Refresh access tokens.
• revokeToken: Log out tokens and revoke access permissions.

In summary, MAVAE offers a comprehensive image processing solution that supports the entire process from generation to management. Combined with Docker deployment, it can be easily integrated into existing projects, enhancing development efficiency and user experience.