Muse Image MCP Server

by kevintsai1202io.github.kevintsai1202/muse-imagev0.1.3

Generate, edit and iteratively refine images with Meta Muse, returning file paths not base64.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active28d ago

Install Muse Image MCP server

claude mcp add muse-image -e MUSE_API_KEY='<muse-api-key>' -- npx -y muse-image-mcp

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "muse-image": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "muse-image-mcp"
      ],
      "env": {
        "MUSE_API_KEY": "<muse-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MUSE_API_KEY	yes	yes	Meta Model API key, created at https://dev.meta.ai under API keys
MUSE_MODEL	—	—	Model ID to use by default
MUSE_OUTPUT_DIR	—	—	Absolute path for saved images. Defaults to generated-images/ under whatever directory the client launched the server from

Freshness

Active — last maintenance signal 28d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-12 · 28d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-12 · 28d ago · official registry · v0.1.3

FAQ

›How do I install the Muse Image MCP server in Claude Code?

Run: claude mcp add muse-image -e MUSE_API_KEY='<muse-api-key>' -- npx -y muse-image-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Muse Image require an API key?

Yes. It expects MUSE_API_KEY, of which 1 is a secret.

›Can I use Muse Image as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Muse Image in the official MCP registry?

Yes, as io.github.kevintsai1202/muse-image.