AI Watercolor Generator MCP server

AI Watercolor Generator MCP

Create watercolor art from text or transform local images with AI from any MCP client that supports local stdio servers.

This package is the official local MCP server for AI Watercolor Generator. It is a small, open-source client for the production API: generation, storage, credits, rate limits, and task processing remain on the hosted service.

Features

• Generate watercolor artwork from a text prompt.
• Upload a local JPEG, PNG, or WebP image for editing.
• Transform uploaded images into watercolor paintings.
• Poll asynchronous tasks until an output is ready.
• Use the same account and credits as the REST API and hosted MCP server.

Requirements

• Node.js 20 or newer
• An AI Watercolor Generator API key
• Account credits for generation and editing

Keep your API key private. Do not commit it to a repository or paste it into an issue.

Quick start

Run the MCP server through npm without a global installation:

AIWATERCOLOR_API_KEY=YOUR_AIWATERCOLOR_API_KEY \
  npx -y @ai-watercolor-generator/mcp

The process communicates over stdio, so it is normally launched by an MCP client rather than used interactively.

Client configuration

Codex

Codex CLI, the Codex IDE extension, and the ChatGPT desktop app share MCP configuration on the same Codex host. Add this to ~/.codex/config.toml and provide AIWATERCOLORAPIKEY in the environment that starts Codex:

[mcp_servers.ai_watercolor_generator]
command = "npx"
args = ["-y", "@ai-watercolor-generator/mcp"]
env_vars = ["AIWATERCOLOR_API_KEY"]

Restart the client, then run codex mcp list or use /mcp to verify the connection. See the official Codex MCP documentation.

Cursor

Add this server to your project .cursor/mcp.json or global MCP configuration:

{
  "mcpServers": {
    "ai-watercolor-generator": {
      "command": "npx",
      "args": ["-y", "@ai-watercolor-generator/mcp"],
      "env": {
        "AIWATERCOLOR_API_KEY": "YOUR_AIWATERCOLOR_API_KEY"
      }
    }
  }
}

See the Cursor MCP documentation.

Claude Desktop and other JSON-based clients

Use the same stdio configuration in the client's local MCP settings:

{
  "mcpServers": {
    "ai-watercolor-generator": {
      "command": "npx",
      "args": ["-y", "@ai-watercolor-generator/mcp"],
      "env": {
        "AIWATERCOLOR_API_KEY": "YOUR_AIWATERCOLOR_API_KEY"
      }
    }
  }
}

Restart the client after saving. Claude Desktop may present local MCP servers through its Extensions interface; see Anthropic's local MCP server guide for the current setup flow.

Tools

Shortened. The full README is on GitHub.