AI导哈

AI照片视频增强服务

HitPaw MCP Server是一个AI驱动的照片和视频增强服务，通过16种照片模型和8种视频模型提供高质量的图像修复和增强功能。

  • by HitPaw-Official
  • Go
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 HitPaw-Official/hitpaw-mcp-server

使用说明

HitPaw MCP服务器

MCP（模型上下文协议）服务器，允许Claude直接调用HitPaw AI照片/视频增强服务。

特性

  • 🖼️ 照片增强 -16个AI模型，支持肖像美化、一般超分辨率、去噪和生成恢复
  • 🎬 视频增强 -8款AI模型，支持人像还原、普通还原、超高清还原
  • 📋 任务查询 -实时查询处理状态和结果
  • 📁 文件管理 -将URL保存到OSS，批量传输
  • 📖 模型列表 -查看所有可用型号和使用建议

快速开始

方法1：直接使用npx运行（推荐）

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

方法2：通过npm进行全局安装

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

方法3：从源代码构建

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

配置Claude桌面

编辑配置文件：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %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"
      }
    }
  }
}

如果从源代码构建，您可以直接指向二进制文件：

{
  "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"
      }
    }
  }
}

配置后重新启动Claude Desktop。

配置游标IDE

编辑 ~/.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"
      }
    }
  }
}

环境变量

变量 必填 默认 描述
HITPAW_API_KEY ✅ - HitPaw API密钥
HITPAW_API_BASE_URL ❌ https://api-base.hitpaw.com API服务URL

用法示例

在克劳德聊天：

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://...

可用工具

工具名称 描述
photo_enhance 照片增强/超分辨率
video_enhance 视频增强/超分辨率
task_status 查询任务状态
oss_transfer 将URL文件传输到OSS
oss_batch_transfer 批量将URL传输到OSS
list_photo_models 列出照片增强型号
list_video_models 列出视频增强型号

照片增强模型

肖像模特

型号 高档 描述
face_2x 2x 人像清晰柔和（美化效果）
face_4x 4x 人像清晰柔和（美化效果）
face_v2_2x 2x 肖像自然逼真（保留纹理）
face_v2_4x 4x 肖像自然逼真（保留纹理）

一般模型

型号 高档 描述
general_2x 2x 普通高清增强
general_4x 4x 普通高清增强
high_fidelity_2x 2x 高保真度（保留原始风格）
high_fidelity_4x 4x 高保真度（保留原始风格）

去噪模型

型号 高档 描述
sharpen_denoise_1x 1x 锐化和降噪
detail_denoise_1x 1x 终极保真度去噪

生成模型（SD）

型号 高档 描述
generative_portrait_1x/2x/4x 1x/2x/4x 生成肖像修复
generative_1x/2x/4x 1x/2x/4x 生成性全面修复

视频增强模型

型号 描述
face_soft_2x 面部柔软增强2x
portrait_restore_1x/2x 肖像修复
general_restore_1x/2x/4x 全面修复
ultrahd_restore_2x 超高清还原（SD）
generative_1x 生成增强（SD）

发展

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

发布

# 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

许可证

麻省理工学院

相关 MCP