Topaz Labs

@topazlabs/mcp

面向大模型的 AI 图像增强。 一个 MCP 服务，让 Claude 和其他 AI 助手使用 Topaz Labs AI 模型增强图像。

Topaz Labs 提供 AI 图像和视频增强软件，全球各地的摄影师、电影制作人和开发者都在使用。

效果展示

增强前	增强后

使用 Wonder 2 模型增强。查看交互式对比 →

快速开始

1. 获取 API 密钥

在 developer.topazlabs.com 注册。

2. 添加到 MCP 客户端

将配置添加到 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

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

3. 增强图像

你：“使用 Wonder 2 增强 ~/Desktop/photo.jpg”

**Claude：**我会使用 Topaz Labs 的 Wonder 2 模型增强你的照片。

[调用 image-enhance 工具]

**注意：**此工具需要文件路径或 URL，无法处理直接上传到聊天中的图像。它最适合与 Claude Cowork 搭配使用，因为 Claude Cowork 可以访问文件系统。它无法在 Claude Chat 模式下运行（没有文件系统访问权限）。

这是增强后的图像——经过放大和锐化，细节和清晰度都得到提升。

兼容性

此服务使用 stdio 传输，所有主流 MCP 桌面客户端均支持：

客户端	状态
Claude Cowork	✅（推荐 — 可访问文件系统）
Claude Desktop (Chat)	⚠️ 需要用户手动提供文件路径
Cursor	✅
Windsurf	✅
VS Code (Copilot)	✅
Cline	✅
Claude Code	✅
Zed	✅

目前尚不支持 HTTP 流式传输（适用于 ChatGPT、远程 Agent、网页/移动客户端），但未来版本可能会添加。

工具

image-enhance

发送图像，获取增强后的版本。默认使用 Standard V2，并自动放大至 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

尺寸选项：{ width, height } 表示精确尺寸，{ width } 或 { height } 表示按比例调整，{ scale } 表示缩放倍数。如果省略此项，宽度小于 2K 的图像会自动放大至 2K。

模型：

模型	类型	适用场景
Standard V2	standard	通用照片（默认）
Low Resolution V2	standard	小尺寸图像、缩略图
CGI	standard	数字艺术、渲染图、插画
High Fidelity V2	standard	需要放大的高质量源图
Redefine	generative	创意性重新诠释
Recover 3	generative	低分辨率图像、老照片
Standard MAX	generative	最高画质，速度较慢
Wonder 2	generative	自然摄影、人像、精细细节

环境变量

变量	必需	描述
TOPAZ_API_KEY	是	Topaz Labs API 密钥

架构

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

开发

npm install
npm run build
npm test

限制

• 仅支持图像 —— 暂不支持视频增强
• 需要付费 API 密钥 —— 请在 developer.topazlabs.com 注册
• 云端处理 —— 图像会发送至 Topaz Labs API 进行增强

参与贡献

发现了 Bug 或有功能请求？请在 GitHub 上提交问题。

许可证

MIT —— Topaz Labs