HitPaw MCP Server

An MCP (Model Context Protocol) server that allows Claude to directly invoke the HitPaw AI photo/video enhancement services.

Features

• 🖼️ Photo Enhancement - 16 AI models, supporting portrait beautification, general super-resolution, denoising, and generative restoration
• 🎬 Video Enhancement - 8 AI models, supporting portrait restoration, general restoration, and ultra-HD restoration
• 📋 Task Query - Real-time query of processing status and results
• 📁 File Management - Save URLs to OSS, batch transfer
• 📖 Model List - View all available models and usage suggestions

Quick Start

Method 1: Run directly with npx (Recommended)

export HITPAW_API_KEY=your_api_key_here
# Optional:
# export HITPAW_API_BASE_URL=https://api-base.hitpaw.com
npx @hitpaw/mcp-server

Method 2: Global installation via npm

npm install -g @hitpaw/mcp-server
hitpaw-mcp-server

Method 3: Build from source

git clone https://github.com/hitpaw/mcp-server-hitpaw.git
cd mcp-server-hitpaw
make build
./build/hitpaw-mcp-server

Configure Claude Desktop

Edit the configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hitpaw": {
      "command": "npx",
      "args": ["-y", "@hitpaw/mcp-server"],
      "env": {
        "HITPAW_API_KEY": "your_api_key_here",
        "HITPAW_API_BASE_URL": "https://api-base.hitpaw.com"
      }
    }
  }
}

If built from source, you can point directly to the binary:

{
  "mcpServers": {
    "hitpaw": {
      "command": "/path/to/hitpaw-mcp-server",
      "env": {
        "HITPAW_API_KEY": "your_api_key_here",
        "HITPAW_API_BASE_URL": "https://api-base.hitpaw.com"
      }
    }
  }
}

Restart Claude Desktop after configuration.

Configure Cursor IDE

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hitpaw": {
      "command": "npx",
      "args": ["-y", "@hitpaw/mcp-server"],
      "env": {
        "HITPAW_API_KEY": "your_api_key_here",
        "HITPAW_API_BASE_URL": "https://api-base.hitpaw.com"
      }
    }
  }
}

Environment Variables

Usage Examples

Chat in Claude:

User: Please enhance this photo https://example.com/photo.jpg

Claude: I'll help you enhance this image. Let me check the available models first...
[Calls list_photo_models]
This photo looks like a portrait, I recommend using the face_2x model to upscale it by 2x.
[Calls photo_enhance(model_name="face_2x", img_url="https://example.com/photo.jpg")]
Task created, task ID is xxx-xxx. Let me check the processing status...
[Calls task_status(job_id="xxx-xxx")]
Processing complete! Here is the link to the enhanced photo: https://...

Available Tools

Photo Enhancement Models

Portrait Models

General Models

Denoising Models

Generative Models (SD)

Video Enhancement Models

Development

make build          # Build
make build-all      # Cross-platform build
make test           # Test
HITPAW_API_KEY=xxx make run  # Run locally

Release

# 1. Cross-platform build
bash scripts/build.sh 1.0.0

# 2. Create GitHub Release
gh release create v1.0.0 build/*

# 3. Publish npm package
cd npm && npm publish --access public

License

MIT