Muse Image MCP server

muse-image-mcp

English · 繁體中文 · 简体中文

An MCP server that gives any MCP-capable agent — Claude Code, Claude Desktop, Cursor — image generation powered by the Meta Muse image model.

What it does

Three tools, covering the full loop of working with images in a conversation:

Why this server

Your context window survives. Every tool writes images to disk and returns an absolute file path — never the image bytes. Generating a dozen images costs you a dozen lines of context instead of a dozen megabytes of base64. When you actually want to look at an image, open the path with a file-reading tool.

Multi-turn refinement without state. iterateimage returns a responseid; feed it back as previousresponseid and the next turn continues the same conversation. The server itself stores nothing — conversation state lives on Meta's side, so the server stays restartable and stateless.

New models don't require a new release. Switch models with MUSEMODEL or a per-call model parameter, and pass parameters this server has never heard of through extraparams. Fields that determine request structure are protected from being overwritten; everything else is a deliberate escape hatch.

You always know what it cost. Every response ends with the estimated cost of that call.

Requirements

• Node.js >= 20.12.0
• A Meta Muse API key

Getting an API key

Muse Image runs on the Meta Model API, so you register with Meta — not with this project:

1. Go to **** and sign in to the Meta Model API dashboard.
2. Open API keys.
3. Click Create API key and copy the value.

That value is what you pass as MUSEAPIKEY below. Meta's own documentation calls this variable MODELAPIKEY; this server reads it as MUSEAPIKEY, talks to https://api.meta.ai/v1, and defaults to the model muse-image-1.0.

Reference: Model API docs · Image generation · Muse Image announcement

Keep the key out of source control — use the MCP config's env block or a .env file, both described below.

Install

Option 1: npx (recommended — no clone required)

claude mcp add muse-image --scope user --env MUSE_API_KEY=your-key -- npx -y muse-image-mcp

npx fetches and runs the latest version on demand — nothing to install first.

• --scope user applies it to every project; use --scope local for the current project only.
• -y skips npx's install prompt. Without it the server hangs on an interactive question and the handshake fails.
• Everything after -- is the launch command; --env before it belongs to claude mcp add.

For other MCP clients (Claude Desktop, Cursor), write the config by hand:

{
  "mcpServers": {
    "muse-image": {
      "command": "npx",
      "args": ["-y", "muse-image-mcp"],
      "env": { "MUSE_API_KEY": "your-key" }
    }
  }
}

On Windows, if npx can't be found, use "command": "cmd" with "args": ["/c", "npx", "-y", "muse-image-mcp"].

Option 2: Local clone (when you want to change the code)

Shortened. The full README is on GitHub.