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

Variable	Required	Default	Description
HITPAW_API_KEY	✅	-	HitPaw API Key
HITPAW_API_BASE_URL	❌	https://api-base.hitpaw.com	API Service URL

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

Tool Name	Description
photo_enhance	Photo enhancement/super resolution
video_enhance	Video enhancement/super resolution
task_status	Query task status
oss_transfer	Transfer URL file to OSS
oss_batch_transfer	Batch transfer URLs to OSS
list_photo_models	List photo enhancement models
list_video_models	List video enhancement models

Photo Enhancement Models

Portrait Models

Model	Upscale	Description
face_2x	2x	Portrait clear and soft (beautification effect)
face_4x	4x	Portrait clear and soft (beautification effect)
face_v2_2x	2x	Portrait natural and realistic (preserves texture)
face_v2_4x	4x	Portrait natural and realistic (preserves texture)

General Models

Model	Upscale	Description
general_2x	2x	General HD enhancement
`general_

... View full README on GitHub