@arcaelas/mcp

A modular MCP (Model Context Protocol) server providing AI-powered tools for image generation, text-to-speech, background removal, and image upscaling.

Installation

npm install -g @arcaelas/mcp

Usage

stdio Mode

For Claude Desktop, Cline, and other MCP clients that support stdio transport:

arcaelas-mcp --stdio

Claude Desktop Configuration (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "arcaelas": {
      "command": "npx",
      "args": ["-y", "@arcaelas/mcp", "--stdio"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "CLIENT_ID": "your-client-id"
      }
    }
  }
}

HTTP/SSE Mode

For clients that support HTTP transport (Cursor, etc.):

# Default port (3100)
arcaelas-mcp

# Custom port
arcaelas-mcp --port 8080

Endpoints:

Endpoint	Method	Description
/sse	GET	Server-Sent Events connection
/messages	POST	Send messages (requires sessionId query param)
/health	GET	Health check and server info

Tools

image

Generate images using AI with optional reference images for style guidance.

Parameter	Type	Required	Default	Description
prompt	string	Yes	-	Image description in English
width	number	No	1024	Output width (max 1024, auto-scaled if larger)
height	number	No	1024	Output height (max 1024, auto-scaled if larger)
reference_images	array	No	[]	Paths to reference images (max 2, max 3MB each)

audio

Convert text to speech with natural-sounding voices.

Parameter	Type	Required	Default	Description
text	string	Yes	-	Text to synthesize
voice	string	No	nova	Voice: nova, alloy, echo, fable, onyx, shimmer, coral, sage

bgcleaner

Remove backgrounds from images using AI with high precision edge detection.

Parameter	Type	Required	Description
image_path	string	Yes	Absolute path to source image (PNG, JPG, WEBP)

Output: Returns path to folder containing processed PNG with transparent background.

resize

Upscale images using AI without quality loss.

Parameter	Type	Required	Default	Description
image_path	string	Yes	-	Absolute path to source image
scale	number	No	2	Scale factor: 2, 3, or 4
model	string	No	plus	Model: diffuser, plus, general
face_enhance	boolean	No	false	Enhance faces (plus/general only)

Models:

• diffuser — Best for small images, more creative results
• plus — Balanced for medium to large images
• general — Optimized for very large images

Environment Variables

Variable	Required	Description
OPENAI_API_KEY	Yes*	OpenAI API key (required for image and audio tools)
OPENAI_BASE_URL	No	Custom OpenAI-compatible API endpoint
CLIENT_ID	Yes*	Client ID for image processing services (required for bgcleaner and resize)

CLI Arguments

Argument	Description
--stdio	Run in stdio mode (for Claude Desktop, etc.)
--port <number>	HTTP server port (default: 3100)
--client-id <id>	Client ID for image processing services
--openai-key <key>	OpenAI API key
--openai-url <url>	Custom OpenAI-compatible API endpoint

Examples

# Using CLI arguments
npx -y @arcaelas/mcp --stdio --client-id xxx --openai-key sk-xxx

# Using environment variables
OPENAI_API_KEY=sk-xxx CLIENT_ID=xxx npx -y @arcaelas/mcp --stdio

# HTTP server on custom port
npx -y @arcaelas/mcp --port 8080 --client-id xxx --openai-key sk-xxx

License

MIT