npm package: @meart/mcp-server
Description: MCP Server for MEart AI image/video generation platform
Latest version: 1.0.5

# MEart MCP Server

MCP (Model Context Protocol) server for [MEart](https://meart-ai.com) AI generation platform. Generate images and videos directly from Claude Desktop or Claude Code.

## Features

- **AI Image Generation**: 10+ models including Flux, Seedream, NanoBanana, and more
- **AI Video Generation**: 15+ models including Kling, Sora, VEO, Vidu, Pixverse, and more
- **Image Tools**: Background removal, image upscaling/enhancement
- **Account Info**: Check credit balance, view generation history, list available models

## Quick Start

### 1. Get Your API Key

1. Visit [MEart Tools](https://meart-ai.com/tools/mcp)
2. Log in to your MEart account
3. Click **Generate New Key**
4. Copy and save your API key (shown only once)

### 2. Configure Claude

#### Claude Code (CLI)

Add to `~/.claude/settings.json` (macOS/Linux) or `%USERPROFILE%\.claude\settings.json` (Windows):

```json
{
  "mcpServers": {
    "meart": {
      "command": "npx",
      "args": ["-y", "@meart/mcp-server"],
      "env": {
        "MEART_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

#### Claude Desktop

Add to config file:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "meart": {
      "command": "npx",
      "args": ["-y", "@meart/mcp-server"],
      "env": {
        "MEART_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### 3. Restart Claude

Restart Claude Desktop or your terminal session, then start creating!

## Environment Variables

| Variable | Required | Description | Default |
|----------|----------|-------------|---------|
| `MEART_API_KEY` | **Yes** | Your MEart API key from [meart-ai.com/tools/mcp](https://meart-ai.com/tools/mcp) | - |
| `MEART_DEFAULT_IMAGE_MODEL` | No | Default image model | `flux-2-dev` |
| `MEART_DEFAULT_VIDEO_MODEL` | No | Default video model | `kling2.5standard` |

## Usage Examples

Once configured, just ask Claude naturally:

- *"Generate an image of a sunset over mountains"*
- *"Create a 5-second video of a cat playing"*
- *"Remove the background from this image"*
- *"Check my MEart credit balance"*
- *"What image models are available?"*

## Available Tools

### meart_generate

Generate AI images or videos.

```
// Image generation
"Generate an image of a beautiful sunset"
"Create a cyberpunk city using seedream4.5 model"

// Video generation
"Create a 5-second video of ocean waves"
"Generate a video of a dancing robot using veo3.1"
```

**Supported parameters:**
- `action`: `image` or `video`
- `prompt`: Description of what to generate
- `model`: Specific model to use (optional)
- `aspect_ratio`: Image/video ratio (e.g., `16:9`, `9:16`, `1:1`)
- `duration`: Video length in seconds
- And more model-specific options

### meart_transform

Transform existing images.

```
// Background removal
"Remove the background from this image: [url]"

// Image enhancement
"Upscale this image 2x: [url]"
```

### meart_query

Query account and model information.

```
// Check credits
"How many credits do I have?"

// List models
"What video models are available?"

// View history
"Show my recent generations"
```

## Supported Models

### Image Models
| Model | Description |
|-------|-------------|
| `flux-2-dev` | Flux 2 Dev (default) |
| `flux-2-pro` | Flux 2 Pro |
| `flux-2-max` | Flux 2 Max |
| `seedream4.5` | Seedream 4.5 |
| `nanobanana` | NanoBanana |
| `nanobanana-pro` | NanoBanana Pro |
| `reve` | Reve |
| `gpt-image-1.5` | GPT Image 1.5 |

### Video Models
| Model | Description |
|-------|-------------|
| `kling2.5standard` | Kling 2.5 Standard (default) |
| `kling2.5pro` | Kling 2.5 Pro |
| `kling2.6pro` | Kling 2.6 Pro |
| `veo3.1` | Google VEO 3.1 |
| `sora2` | Sora 2 |
| `sora2pro` | Sora 2 Pro |
| `viduq2` | Vidu Q2 |
| `pixverse5.5` | Pixverse 5.5 |
| `wan2.5` | Wan 2.5 |
| `seedancev1pro` | Seedance V1 Pro |

## Security

- Your API key is linked to your MEart account
- Never share your API key publicly
- You can revoke keys anytime at [meart-ai.com/tools/mcp](https://meart-ai.com/tools/mcp)
- All generations use your MEart credits

## Support

- **API Key Management**: [meart-ai.com/tools/mcp](https://meart-ai.com/tools/mcp)
- **MEart Platform**: [meart-ai.com](https://meart-ai.com)
- **MCP Documentation**: [modelcontextprotocol.io](https://modelcontextprotocol.io)

## License

MIT