markitup-mcp-server

markitup-mcp-server

MarkItUp 用の MCP（Model Context Protocol）サーバーです。AI を活用した画像注釈とマーケティングビジュアル生成を行います。Claude Code、Claude Desktop、Cursor、MCP 対応の ChatGPT などのクライアントから MarkItUp を直接呼び出せます。

利用できるツールは 5 つです：markitup_credit_balance、markitup_generate、markitup_regen、markitup_extend、markitup_remove_background。

前提条件

1. MarkItUp アカウント — https://markitup.app で登録してください。
2. MarkItUp API キー — https://markitup.app/dashboard で生成してください。
3. Node.js 18 以降（ローカルにインストールする場合のみ。MCP クライアントに Node.js が同梱されている場合、npx の実行にローカルの Node.js は不要です）。

Claude Code での設定

MCP 設定（~/.claude/mcp.json またはプロジェクト単位の .mcp.json）に追加します。

{
  "mcpServers": {
    "markitup": {
      "command": "npx",
      "args": ["-y", "markitup-mcp-server"],
      "env": {
        "MARKITUP_API_KEY": "mk_live_..."
      }
    }
  }
}

Claude Desktop での設定

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "markitup": {
      "command": "npx",
      "args": ["-y", "markitup-mcp-server"],
      "env": {
        "MARKITUP_API_KEY": "mk_live_..."
      }
    }
  }
}

Cursor での設定

Cursor では同じ JSON 形式を使用します。Settings → MCP → Add Server：

{
  "mcpServers": {
    "markitup": {
      "command": "npx",
      "args": ["-y", "markitup-mcp-server"],
      "env": { "MARKITUP_API_KEY": "mk_live_..." }
    }
  }
}

ツール

markitup_credit_balance

現在のクレジット残高とサブスクリプションの状態を返します。

引数はありません。API キーが有効か確認するときや、生成ツールを呼び出す前にクレジット残高を確認するときに使用します。

markitup_generate

スクリーンショットから、洗練されたマーケティングビジュアルを 3 種類生成します。クレジットを 1 消費します。

引数	型	必須	説明
description	文字列	はい	画像に何が表示されているか、何を強調するか
template_id	文字列	はい	glassmorphic、clean_minimal、bold_marketing、dark_professional、documentation（ほかにもあります）から 1 つ
image_url	文字列	どちらか一方	元画像の公開 HTTPS URL
image_base64	文字列	どちらか一方	Base64 エンコードされた画像データ（data: プレフィックスなし）
image_mime_type	文字列	いいえ	image_base64 を指定する場合の MIME タイプ。デフォルト：image/png
aspect_ratio	文字列	いいえ	1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9 のいずれか
image_size	文字列	いいえ	1K、2K、または 4K

戻り値：マーケティング用コピー（見出し、サブ見出し）と、Base64 画像コンテンツブロックとして生成された 3 種類の画像バリエーションです。完全な構造化レスポンスは structuredContent からも取得できます。

プロンプトの例（Claude Code の場合）：

https://example.com/dashboard.png にあるスクリーンショットを使って markitup_generate を実行してください。エクスポートボタンを強調し、bold_marketing テンプレートを使ってマーケティング用ランディングページ向けにアピールしてください。

markitup_regen

以前の markitup_generate 呼び出しで生成したバリエーションを 1 つ再生成します。デフォルトではクレジットを 1 消費します（クレジットを消費しない場合は charge_credit: false を指定します）。

再生成後も同じ見出し／サブ見出しでブランドイメージを維持できるよう、LLM は前回の generate の structuredContent.text に含まれる text_analysis オブジェクトを渡し戻す必要があります。variation_index で対象のスロット（0～2）を選択します。

markitup_extend

AI によるアウトペイント — 画像を拡張して、より大きなキャンバスや異なるアスペクト比にします。クレジットを 1 消費します。

引数	型	必須	説明
image_url / image_base64	文字列	どちらか一方	元画像
aspect_ratio	文字列	はい	目標のアスペクト比（16:9、9:16 など）
target_width / target_height	数値	はい	出力画像のピクセル寸法
image_size	文字列	いいえ	1K、2K、または 4K

markitup_remove_background

Photoroom の HD モデルを使用して画像の背景を削除します。透過 PNG を返します。クレジットを 1 消費します（アクティブな Pro／Power サブスクライバーは無料です）。

引数	型	必須	説明
image_url / image_base64	string	いずれか 1 つ	元画像

環境変数

変数	必須	説明
MARKITUP_API_KEY	はい	MarkItUp ダッシュボードで取得した API キー
MARKITUP_API_BASE	いいえ	API ベース URL を上書きします。デフォルト：https://markitup.app/api/v1。ステージング環境に対するテストに便利です。

ローカル開発

git clone https://github.com/markitup/mcp-server.git
cd mcp-server
npm install
npm run build

# Point your MCP client config at the local build:
{
  "command": "node",
  "args": ["/absolute/path/to/mcp-server/dist/index.js"],
  "env": { "MARKITUP_API_KEY": "mk_test_..." }
}

セキュリティ

• MARKITUP_API_KEY をソース管理にコミットしないでください。
• 誤ってキーを公開した場合は、https://markitup.app/dashboard で直ちにキーを無効化し、新しいキーを作成してください。
• キーはサーバー上で SHA-256 ハッシュ化されます。元のキーが表示されるのは作成時の 1 回のみです。

エラー

一般的なケースでは、サーバーはわかりやすいエラーメッセージを表示します。

• Invalid or missing MARKITUP_API_KEY — キーを設定するか、ローテーションしてください。
• Out of MarkItUp credits — https://markitup.app/credits でクレジットをチャージしてください。
• Rate limit exceeded — 少し待ってから再試行してください。

ライセンス

MIT