Mavae Image Toolbox

🚀 MAVAE - 画像ツールボックス

MAVAEは、AIエージェント向けに設計された、強力なクリエイティブ生成と編集ツールキットです。このツールボックスを使用することで、画像の生成から管理までの一連のプロセスを効率的に行うことができます。

MAVAEは、画像メディアツールとやり取りするためのModel Context Protocol (MCP) サーバーです。AIエージェントに対して、画像の生成と操作を行うための標準的なインターフェースを提供します。

🚀 クイックスタート

MAVAEを使用することで、AIエージェントは画像の生成や編集、管理などの操作を簡単に行うことができます。以下に、MAVAEの基本的な機能と使用方法を紹介します。

✨ 主な機能

• 画像生成：オリジナルの設定または事前定義されたセットを使用して画像を生成します。
• 画像編集：画像の圧縮、トリミング、サイズ調整を行い、比率または固定次元をサポートします。
• セット管理：設定を作成、管理、共有して、一貫した画像生成を保証します。
• モデルとLoRA管理：利用可能なモデルとLoRAをリストして使用します。
• APIトークン管理：認証を処理して、Mavaeサービスと安全にやり取りします。

📋 前提条件

• Node.js (v16以上のバージョン)
• MAVAE APIキー（環境変数として設定、ここで申請）

📦 インストール

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

# サーバーの起動
npm start

MCP Json

{
  "mcpServers": {
      "mavae": {
          "command": "node",
          "args": [
              "***/dist/index.js"
          ],
          "env": {
              "MAVAE_API_KEY": MAVAE_API_KEY
          }
      }
  }
}

MAVAE MCPをローカルで使用する場合、このパスは絶対パスになります 👉🏻 "***/dist/index.js"

🐳 Docker サポート

# Dockerイメージのビルド
docker build -t mavae-mcp-server .

# Dockerコンテナの実行
docker run -e MAVAE_API_KEY=your_api_key mavae-mcp-server

📚 ドキュメント

📁 プロジェクト構造

mavae/
├── src/                  # ソースコード
│   ├── mavae.ts        # コア機能の実装
│   └── index.ts       # エントリーファイル
└── dist/               # ビルド出力ディレクトリ
    └── main.js         # パッケージ化されたメインプログラム

🔧 機能モジュール

画像生成

• generateImage: AIモデルを使用して高品質の画像を生成します。
• editImage: 既存の画像に対して高度な編集操作を行います。
• saveImage: 処理後の画像を指定のパスに保存します。

画像管理

• getImageList: すべての処理済み画像のリストを取得します。
• deleteImage: 指定された画像ファイルを削除します。
• exportImage: 画像を複数の形式（PNG, JPG, WEBP）でエクスポートします。

モデルとリソース管理

• listModels: 利用可能なAIモデルをリストします。
• loadModel: 特定のモデルをロードして処理を行います。
• updateModel: モデルの設定またはパラメータを更新します。

セキュリティと認証

• authenticateToken: APIトークンの状態を検証します。
• refreshToken: アクセストークンを更新します。
• revokeToken: トークンを取り消し、アクセス権限を取り消します。

以上の機能により、MAVAEは画像生成から管理までの完全なプロセスをサポートする包括的な画像処理ソリューションを提供します。Dockerを使用したデプロイにより、既存のプロジェクトに簡単に統合でき、開発効率とユーザー体験を向上させます。