Stamp it - Apply a full-screen watermark to an image

by LiuHao-1443

136 downloads Not rated yet

GitHub

Media

About

A lightweight MCP component for adding text watermarks to pictures.

Explore

- 🖼️ Dual Watermark Modes: Support for both text and image watermarks
- 📂 Local File Processing: Professional local image file handling
- 🎨 Smart Adaptive Colors: Automatic color selection based on image brightness
- 📐 Tilted Watermark Effects: Customizable angle tilting (default 30° upward right)
- 🌍 Multi-language Support: Chinese, English, Japanese, Korean and more
- 🎯 High-density Coverage: Complete coverage of every corner with no gaps
- 💎 High Definition: BICUBIC resampling for smooth edges
- 📁 Smart Saving: Auto-save in the same directory as original image
- ⚡ Performance Optimized: Font caching, intelligent scaling, memory management
- 🛠️ Rich Format Support: Supports 7 common image formats

- Smart Color Adaptation
- Bright images: Automatically use dark watermarks (RGB 20,20,20)
- Dark images: Automatically use light/white watermarks (RGB 240,240,240)
- Medium brightness: Intelligently select optimal contrast colors

- Multi-language Font Support
- Auto-detect and load system's best Chinese fonts
- Support for PingFang SC, Microsoft YaHei, SimHei, etc.
- Perfect display of Chinese, Japanese, Korean, and English

- High-quality Rendering
- Font caching for improved performance
- BICUBIC resampling for smooth edges
- Centered rendering with excellent rotation effects

- Smart Scaling: Auto-scale to appropriate size (default 15%)
- Opacity Control: Automatic opacity adjustment without affecting original image
- Aspect Ratio Preservation: Maintain watermark image aspect ratio
- High-quality Scaling: Use LANCZOS algorithm for clarity

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Stamp it - Apply a full-screen watermark to an image

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

From the repository

uv pip install fastmcp pillow

uv pip install -e .

You can adjust parameters by modifying the WatermarkConfig class:

python
class WatermarkConfig:
DEFAULT_FONT_SIZE = 36 # Default font size
DEFAULT_ANGLE = 30 # Default tilt angle
SPACING_X_FACTOR = 1.1 # Horizontal spacing multiplier
SPACING_Y_FACTOR = 0.9 # Vertical spacing multiplier
BRIGHTNESS_THRESHOLDS = { # Brightness thresholds
'very_bright': 180,
'medium': 120,
'dark': 60
}
```

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "stamp it - apply a full-screen watermark to an image": {
            "stampit": {
                "command": "uvx",
                "args": [
                    "mcp-stampit"
                ]
            }
        }
    }
}

McpServers

{
    "stampit": {
        "command": "uvx",
        "args": [
            "mcp-stampit"
        ]
    }
}

A professional image watermarking service built with FastMCP, supporting both text and image watermarks with intelligent color adaptation.

中文文档 | English

✨ Key Features

📖 Usage

MCP Client Configuration

Cherry Studio (Recommended)

1. Open Cherry Studio Settings
- Go to Settings → MCP Servers
- Click "Add Server"

2. Configure MCP Server

Cherry Studio MCP Configuration

3. Save and Connect
- Click "Save" to add the server
- The server will automatically connect
- You can now use the watermark tools in Cherry Studio

Cherry Studio MCP Tools

Cursor

1. Open Cursor Settings
- Use shortcut Cmd+, (Mac) or Ctrl+, (Windows/Linux)
- Or click Settings → Preferences

2. Configure MCP Server
- Find "MCP Servers" configuration option
- Add the following configuration:

{
  "mcpServers": {
    "stampit": {
      "command": "uvx",
      "args": [
        "mcp-stampit"
      ]
    }
  }
}

3. Save and Restart
- Save the configuration file
- Restart Cursor for changes to take effect
- You can now use the watermark tools in Cursor

📦 Preview

🚀 Installation

Using uv (Recommended)

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

✨ Key Features

📖 Usage

MCP Client Configuration

Cherry Studio (Recommended)

Cursor

📦 Preview

🚀 Installation

Using uv (Recommended)

More like this

Google Maps

BlenderMCP

AWS MCP Servers

Figma Context (Framelink)