1. Conduid
  2. Content
  3. TopazLabs/topaz-mcp
MCP server · Content

TopazLabs/topaz-mcp

by · github.com/TopazLabs/topaz-mcp

Topaz Labs MCP Server — AI image enhancement via Model Context Protocol

Unclaimed MIT last commit 8 months ago content
InstallView source
56Fair

Scored 5 days ago · breakdown

About TopazLabs/topaz-mcp

TopazLabs/topaz-mcp is an MCP server published by TopazLabs in the Content category: topaz Labs MCP Server — AI image enhancement via Model Context Protocol.

The repository has 6 stars and 2 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Claude Code
claude mcp add topaz-mcp -- npx -y @topazlabs/mcp
npx
npx -y @topazlabs/mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about TopazLabs/topaz-mcp

Powered by Claude · Grounded in docs

I know everything about TopazLabs/topaz-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 3 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

@topazlabs/mcp

npm version npm downloads license

AI image enhancement for LLMs. An MCP server that lets Claude and other AI assistants enhance images using Topaz Labs AI models.

Topaz Labs makes AI-powered image and video enhancement software used by photographers, filmmakers, and developers worldwide.

See It in Action

Before After
Before After

Enhanced with the Wonder 2 model. View interactive comparison →

Quick Start

1. Get an API key

Sign up at developer.topazlabs.com.

2. Add to your MCP client

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "Topaz Labs": {
      "command": "npx",
      "args": ["-y", "@topazlabs/mcp"],
      "env": {
        "TOPAZ_API_KEY": "<your-api-key>"
      }
    }
  }
}

3. Enhance images

You: "Enhance ~/Desktop/photo.jpg with Wonder 2"

Claude: I'll enhance your photo using Topaz Labs' Wonder 2 model.

[calls image-enhance tool]

Note: This tool requires a file path or URL — it cannot process images uploaded directly in the chat. It works best with Claude Cowork, which has file system access. It does not work in Claude Chat mode (no file system access).

Here's your enhanced image -- upscaled and sharpened with improved detail and clarity.

Compatibility

This server uses stdio transport, supported by all major MCP desktop clients:

Client Status
Claude Cowork ✅ (recommended — has file system access)
Claude Desktop (Chat) ⚠️ Requires user to provide file paths manually
Cursor ✅
Windsurf ✅
VS Code (Copilot) ✅
Cline ✅
Claude Code ✅
Zed ✅

HTTP streaming transport (for ChatGPT, remote agents, web/mobile clients) is not yet supported but may be added in a future release.

Tool

image-enhance

Send an image, get back an enhanced version. Defaults to Standard V2 and auto-upscales to 2K.

image: "~/Photos/photo.jpg"     # Local path or URL (required)
size: { scale: 2 }              # Optional: exact dims, single dim, or scale factor
model: "Standard V2"            # Optional: defaults to Standard V2

Size options: { width, height } for exact, { width } or { height } for proportional, { scale } for a multiplier. If omitted, images under 2K are auto-upscaled to 2K width.

Models:

Model Type Best for
Standard V2 standard General photos (default)
Low Resolution V2 standard Tiny images, thumbnails
CGI standard Digital art, renders, illustrations
High Fidelity V2 standard High-quality sources needing upscale
Redefine generative Creative reinterpretation
Recover 3 generative Low-res images, old photos
Standard MAX generative Maximum quality, slower
Wonder 2 generative Nature photography, portraits, fine detail

Environment Variables

Variable Required Description
TOPAZ_API_KEY Yes Topaz Labs API key

Architecture

src/
  api/        -- Topaz API client, types, model definitions
  lib/        -- Path security, URL fetching utilities
  tools/      -- enhance tool handler
  server.ts   -- MCP server setup and tool registration
  main.ts     -- Entry point (stdio transport)
test/         -- Vitest test suite

Development

npm install
npm run build
npm test

Limitations

  • Image only -- video enhancement is not yet supported
  • Paid API key required -- sign up at developer.topazlabs.com
  • Cloud processing -- images are sent to the Topaz Labs API for enhancement

Contributing

Found a bug or have a feature request? Open an issue on GitHub.

License

MIT -- Topaz Labs

README fetched from the repository 3 days ago. The original is authoritative.

Questions

About TopazLabs/topaz-mcp

How do I install TopazLabs/topaz-mcp?

Run claude mcp add topaz-mcp -- npx -y @topazlabs/mcp, then add the server to your MCP client's configuration.

Is TopazLabs/topaz-mcp safe to use with an AI agent?

Its trust score is 56 out of 100 (fair). It passes 5 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is TopazLabs/topaz-mcp still maintained?

The last commit was 8 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.