@topazlabs/mcp 0.1.13 → 0.1.14

package/README.md

@@ -1,15 +1,30 @@
 # @topazlabs/mcp
 
-**AI image enhancement for LLMs.** An [MCP server](https://modelcontextprotocol.io) that lets Claude and other MCP-compatible AI assistants enhance images using [Topaz Labs](https://www.topazlabs.com) AI.
+[![npm version](https://img.shields.io/npm/v/@topazlabs/mcp)](https://www.npmjs.com/package/@topazlabs/mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@topazlabs/mcp)](https://www.npmjs.com/package/@topazlabs/mcp)
+[![license](https://img.shields.io/npm/l/@topazlabs/mcp)](https://github.com/topazlabs/topaz-mcp/blob/main/LICENSE)
+
+**AI image enhancement for LLMs.** An [MCP server](https://modelcontextprotocol.io) that lets Claude and other AI assistants enhance images using [Topaz Labs](https://www.topazlabs.com) 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](https://cdn.prod.website-files.com/6005fac27a49a9cd477afb63/696fce95820c4035f17a1159_wondercompare-fidelity-1-original.webp) | ![After](https://cdn.prod.website-files.com/6005fac27a49a9cd477afb63/696fce96e2494c7a7935814b_wondercompare-fidelity-1-wonder2.webp) |
+
+Enhanced with the **Wonder 2** model. [View interactive comparison →](https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fcdn.prod.website-files.com%2F6005fac27a49a9cd477afb63%2F696fce95820c4035f17a1159_wondercompare-fidelity-1-original.webp&src1label=Before&src2=https%3A%2F%2Fcdn.prod.website-files.com%2F6005fac27a49a9cd477afb63%2F696fce96e2494c7a7935814b_wondercompare-fidelity-1-wonder2.webp&src2label=After&view=slider&zoom=1)
 
 ## Quick Start
 
-### Claude Desktop
+### 1. Get an API key
+
+Sign up at [developer.topazlabs.com](https://developer.topazlabs.com/getting-started/how-do-i-get-my-api-key).
 
-Add to your Claude Desktop config:
+### 2. Add to your MCP client
 
-- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
 
 ```json
 {
@@ -25,15 +40,26 @@ Add to your Claude Desktop config:
 }
 ```
 
-Get an API key at [topazlabs.com](https://www.topazlabs.com).
+### 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\]*
+>
+> Here's your enhanced image -- upscaled and sharpened with improved detail and clarity.
+
+> **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).
 
 ## Compatibility
 
-This server uses **stdio transport**, which is supported by all major MCP desktop clients:
+This server uses **stdio transport**, supported by all major MCP desktop clients:
 
 | Client | Status |
 |--------|--------|
-| Claude Desktop / Cowork | ✅ |
+| Claude Cowork | ✅ (recommended — has file system access) |
+| Claude Desktop (Chat) | ⚠️ Requires user to provide file paths manually |
 | Cursor | ✅ |
 | Windsurf | ✅ |
 | VS Code (Copilot) | ✅ |
@@ -74,19 +100,18 @@ model: "Standard V2"            # Optional: defaults to Standard V2
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `TOPAZ_API_KEY` | Yes | Topaz Labs API key |
+| `TOPAZ_API_KEY` | Yes | [Topaz Labs API key](https://developer.topazlabs.com/getting-started/how-do-i-get-my-api-key) |
 
 ## Architecture
 
 ```
-packages/mcp/
-  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
+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
@@ -97,26 +122,16 @@ npm run build
 npm test
 ```
 
-Use `npm run dev -w packages/mcp` to watch for changes during development.
+## Limitations
 
-## Publishing to npm
+- **Image only** -- video enhancement is not yet supported
+- **Paid API key required** -- sign up at [developer.topazlabs.com](https://developer.topazlabs.com/getting-started/how-do-i-get-my-api-key)
+- **Cloud processing** -- images are sent to the Topaz Labs API for enhancement
 
-```bash
-# 1. Build and test
-npm run build && npm test
-
-# 2. Publish
-npm publish -w packages/mcp
-```
-
-To bump the version before publishing:
-
-```bash
-npm version patch -w packages/mcp
-```
+## Contributing
 
-> **Note:** `"access": "public"` is configured in `.npmrc` (required for scoped packages). Make sure you're logged in to an npm account that has access to the `@topazlabs` scope: `npm login`.
+Found a bug or have a feature request? [Open an issue](https://github.com/topazlabs/topaz-mcp/issues) on GitHub.
 
 ## License
 
-MIT — [Topaz Labs](https://www.topazlabs.com)
+MIT -- [Topaz Labs](https://www.topazlabs.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topazlabs/mcp",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Topaz Labs MCP server — AI image enhancement for LLMs",
   "type": "module",
   "bin": {