图片融合MCP

AI Image Merge MCP

An MCP server for AI Image Merge. It exposes the product's real image-combination workflow to MCP clients such as Claude Desktop, Cursor, and other compatible agents.

Licensed under the MIT License.

Website: https://aiimagemerge.com

Tools

• merge_images: submit exactly two public HTTPS JPG, PNG, or WebP URLs and receive a task id.
• get_merge_status: poll a task and receive the generated image URL when it is ready.

The remote service downloads and validates the images, stores them under the authenticated user's storage path, reserves credits, and invokes the configured AI provider. The MCP server never contains an AI provider secret.

Setup

1. Sign in to AI Image Merge.
2. Open Settings → API Keys and create a key.
3. Configure the MCP client with:

{
  "mcpServers": {
    "ai-image-merge": {
      "command": "npx",
      "args": ["-y", "ai-image-merge-mcp"],
      "env": {
        "AI_IMAGE_MERGE_API_KEY": "sk-..."
      }
    }
  }
}

For a local checkout, replace the command with node and the absolute path to src/index.mjs.

Optional environment variable:

AI_IMAGE_MERGE_API_URL=https://aiimagemerge.com

Image requirements

The first version accepts two publicly reachable HTTPS image URLs. Each image must be JPG, PNG, or WebP and no larger than 10 MB. Private IPs, localhost, non-HTTPS URLs, and unsupported content types are rejected.

Development

Run the server directly:

AI_IMAGE_MERGE_API_KEY=sk-... node src/index.mjs

The process speaks newline-delimited JSON-RPC over stdio and keeps stdout reserved for MCP messages.

Run the local protocol smoke test with npm test.

Release and LobeHub listing

This directory is intended to become the root of a separate public GitHub repository, for example lingn/ai-image-merge-mcp. After creating that repository and publishing the package to npm, log in to LobeHub and publish the repository with the included manifest:

npm publish --access public
npx -y @lobehub/market-cli login
npx -y @lobehub/market-cli github connect
npx -y @lobehub/market-cli plugin publish https://github.com/lingn/ai-image-merge-mcp --dir /absolute/path/to/ai-image-merge-mcp

login and github connect open a browser and require the repository owner to complete authorization. The listing's homepage points to https://aiimagemerge.com.